claude-code-swarm 0.0.1 → 0.3.2

package/references/multi-agent-protocol/schema/schema.json

@@ -0,0 +1,3067 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alexngai/multi-agent-protocol/schema/schema.json",
+  "title": "Multi-Agent Protocol Schema",
+  "description": "JSON Schema for the Multi-Agent Protocol (MAP) - a protocol for observing, coordinating, and routing messages within multi-agent AI systems",
+  "oneOf": [
+    { "$ref": "#/$defs/MAPRequest" },
+    { "$ref": "#/$defs/MAPResponse" },
+    { "$ref": "#/$defs/MAPNotification" }
+  ],
+  "$defs": {
+    "JsonRpcVersion": {
+      "type": "string",
+      "const": "2.0",
+      "description": "JSON-RPC version, always '2.0'"
+    },
+    "RequestId": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "integer" }
+      ],
+      "description": "Unique identifier for a request, used to correlate responses"
+    },
+    "MAPRequest": {
+      "type": "object",
+      "description": "A JSON-RPC 2.0 request message in MAP",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "type": "string" },
+        "params": { "type": "object" }
+      },
+      "required": ["jsonrpc", "id", "method"],
+      "additionalProperties": false,
+      "oneOf": [
+        { "$ref": "#/$defs/ConnectRequest" },
+        { "$ref": "#/$defs/DisconnectRequest" },
+        { "$ref": "#/$defs/SessionListRequest" },
+        { "$ref": "#/$defs/SessionLoadRequest" },
+        { "$ref": "#/$defs/SessionCloseRequest" },
+        { "$ref": "#/$defs/AgentsListRequest" },
+        { "$ref": "#/$defs/AgentsGetRequest" },
+        { "$ref": "#/$defs/AgentsRegisterRequest" },
+        { "$ref": "#/$defs/AgentsSpawnRequest" },
+        { "$ref": "#/$defs/AgentsUnregisterRequest" },
+        { "$ref": "#/$defs/AgentsUpdateRequest" },
+        { "$ref": "#/$defs/AgentsStopRequest" },
+        { "$ref": "#/$defs/AgentsSuspendRequest" },
+        { "$ref": "#/$defs/AgentsResumeRequest" },
+        { "$ref": "#/$defs/SendRequest" },
+        { "$ref": "#/$defs/SubscribeRequest" },
+        { "$ref": "#/$defs/UnsubscribeRequest" },
+        { "$ref": "#/$defs/ScopesListRequest" },
+        { "$ref": "#/$defs/ScopesGetRequest" },
+        { "$ref": "#/$defs/ScopesCreateRequest" },
+        { "$ref": "#/$defs/ScopesDeleteRequest" },
+        { "$ref": "#/$defs/ScopesJoinRequest" },
+        { "$ref": "#/$defs/ScopesLeaveRequest" },
+        { "$ref": "#/$defs/ScopesMembersRequest" },
+        { "$ref": "#/$defs/StructureGraphRequest" },
+        { "$ref": "#/$defs/AuthRefreshRequest" },
+        { "$ref": "#/$defs/InjectRequest" },
+        { "$ref": "#/$defs/FederationConnectRequest" },
+        { "$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": {
+      "type": "object",
+      "description": "A JSON-RPC 2.0 response message in MAP",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" }
+      },
+      "required": ["jsonrpc", "id"],
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+            "id": { "$ref": "#/$defs/RequestId" },
+            "result": {}
+          },
+          "required": ["jsonrpc", "id", "result"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+            "id": { "$ref": "#/$defs/RequestId" },
+            "error": { "$ref": "#/$defs/MAPError" }
+          },
+          "required": ["jsonrpc", "id", "error"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "MAPNotification": {
+      "type": "object",
+      "description": "A JSON-RPC 2.0 notification message in MAP (no response expected)",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "method": { "type": "string" },
+        "params": { "type": "object" }
+      },
+      "required": ["jsonrpc", "method"],
+      "additionalProperties": false,
+      "oneOf": [
+        { "$ref": "#/$defs/EventNotification" },
+        { "$ref": "#/$defs/MessageNotification" }
+      ]
+    },
+    "MAPError": {
+      "type": "object",
+      "description": "JSON-RPC 2.0 error object",
+      "properties": {
+        "code": {
+          "type": "integer",
+          "description": "Error code"
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable error message"
+        },
+        "data": {
+          "description": "Additional error data",
+          "$ref": "#/$defs/MAPErrorData"
+        }
+      },
+      "required": ["code", "message"],
+      "additionalProperties": false
+    },
+    "MAPErrorData": {
+      "type": "object",
+      "description": "Structured error data",
+      "properties": {
+        "category": { "$ref": "#/$defs/ErrorCategory" },
+        "retryable": { "type": "boolean" },
+        "retryAfterMs": { "type": "integer" },
+        "details": { "type": "object" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "additionalProperties": true
+    },
+    "ErrorCategory": {
+      "type": "string",
+      "enum": [
+        "protocol",
+        "auth",
+        "routing",
+        "agent",
+        "resource",
+        "federation",
+        "mail",
+        "internal"
+      ],
+      "description": "Category of error for handling decisions"
+    },
+
+    "ParticipantId": {
+      "type": "string",
+      "description": "Unique identifier for any participant (agent, client, system, gateway)"
+    },
+    "AgentId": {
+      "type": "string",
+      "description": "Unique identifier for an agent"
+    },
+    "ScopeId": {
+      "type": "string",
+      "description": "Unique identifier for a scope"
+    },
+    "SessionId": {
+      "type": "string",
+      "description": "Unique identifier for a session"
+    },
+    "MessageId": {
+      "type": "string",
+      "description": "Unique identifier for a message"
+    },
+    "SubscriptionId": {
+      "type": "string",
+      "description": "Unique identifier for a subscription"
+    },
+    "CorrelationId": {
+      "type": "string",
+      "description": "Identifier for correlating related messages"
+    },
+    "ProtocolVersion": {
+      "type": "integer",
+      "const": 1,
+      "description": "MAP protocol version"
+    },
+    "Timestamp": {
+      "type": "integer",
+      "description": "Unix timestamp in milliseconds"
+    },
+    "Meta": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Vendor extension metadata. Implementations MUST NOT assume specific keys."
+    },
+
+    "ParticipantType": {
+      "type": "string",
+      "enum": ["agent", "client", "system", "gateway"],
+      "description": "Type of participant in the protocol"
+    },
+    "ParticipantCapabilities": {
+      "type": "object",
+      "description": "Capabilities of a participant, grouped by category",
+      "properties": {
+        "observation": {
+          "type": "object",
+          "properties": {
+            "canObserve": {
+              "type": "boolean",
+              "description": "Can subscribe to event streams"
+            },
+            "canQuery": {
+              "type": "boolean",
+              "description": "Can query agents and structure"
+            }
+          },
+          "additionalProperties": false
+        },
+        "messaging": {
+          "type": "object",
+          "properties": {
+            "canSend": {
+              "type": "boolean",
+              "description": "Can send messages"
+            },
+            "canReceive": {
+              "type": "boolean",
+              "description": "Can receive messages addressed to it"
+            },
+            "canBroadcast": {
+              "type": "boolean",
+              "description": "Can send to scopes/roles"
+            }
+          },
+          "additionalProperties": false
+        },
+        "lifecycle": {
+          "type": "object",
+          "properties": {
+            "canSpawn": {
+              "type": "boolean",
+              "description": "Can create child agents"
+            },
+            "canRegister": {
+              "type": "boolean",
+              "description": "Can register agents (not as children)"
+            },
+            "canUnregister": {
+              "type": "boolean",
+              "description": "Can remove agents"
+            },
+            "canSteer": {
+              "type": "boolean",
+              "description": "Can inject context/control agents"
+            },
+            "canStop": {
+              "type": "boolean",
+              "description": "Can request agent termination"
+            }
+          },
+          "additionalProperties": false
+        },
+        "scopes": {
+          "type": "object",
+          "properties": {
+            "canCreateScopes": {
+              "type": "boolean",
+              "description": "Can create new scopes"
+            },
+            "canManageScopes": {
+              "type": "boolean",
+              "description": "Can modify and delete scopes"
+            }
+          },
+          "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
+    },
+    "TransportType": {
+      "type": "string",
+      "enum": ["websocket", "stdio", "inprocess", "http-sse"],
+      "description": "Transport binding type"
+    },
+    "Participant": {
+      "type": "object",
+      "description": "A participant in the MAP protocol",
+      "properties": {
+        "id": { "$ref": "#/$defs/ParticipantId" },
+        "type": { "$ref": "#/$defs/ParticipantType" },
+        "name": { "type": "string" },
+        "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+        "transport": { "$ref": "#/$defs/TransportType" },
+        "sessionId": { "$ref": "#/$defs/SessionId" },
+        "metadata": { "type": "object" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "type"],
+      "additionalProperties": false
+    },
+
+    "AgentState": {
+      "type": "string",
+      "description": "State of an agent. Standard states are enumerated; custom states use 'x-' prefix.",
+      "oneOf": [
+        {
+          "enum": [
+            "registered",
+            "active",
+            "busy",
+            "idle",
+            "suspended",
+            "stopping",
+            "stopped",
+            "failed"
+          ]
+        },
+        {
+          "type": "string",
+          "pattern": "^x-[a-z][a-z0-9-]*$",
+          "description": "Custom state with x- prefix"
+        }
+      ]
+    },
+    "AgentRelationship": {
+      "type": "object",
+      "description": "A relationship between agents",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["peer", "supervisor", "supervised", "collaborator"],
+          "description": "Type of relationship"
+        },
+        "agentId": { "$ref": "#/$defs/AgentId" },
+        "metadata": { "type": "object" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["type", "agentId"],
+      "additionalProperties": false
+    },
+    "AgentLifecycle": {
+      "type": "object",
+      "description": "Lifecycle metadata for an agent",
+      "properties": {
+        "createdAt": { "$ref": "#/$defs/Timestamp" },
+        "startedAt": { "$ref": "#/$defs/Timestamp" },
+        "stoppedAt": { "$ref": "#/$defs/Timestamp" },
+        "lastActiveAt": { "$ref": "#/$defs/Timestamp" },
+        "exitCode": { "type": "integer" },
+        "exitReason": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "additionalProperties": false
+    },
+    "AgentVisibility": {
+      "type": "string",
+      "enum": ["public", "parent-only", "scope", "system"],
+      "description": "Who can see this agent"
+    },
+    "Agent": {
+      "type": "object",
+      "description": "An agent in the multi-agent system",
+      "properties": {
+        "id": { "$ref": "#/$defs/AgentId" },
+        "name": { "type": "string" },
+        "description": { "type": "string" },
+        "parent": { "$ref": "#/$defs/AgentId" },
+        "relationships": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/AgentRelationship" }
+        },
+        "state": { "$ref": "#/$defs/AgentState" },
+        "role": { "type": "string" },
+        "scopes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ScopeId" }
+        },
+        "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" }
+      },
+      "required": ["id", "state"],
+      "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": [
+        {
+          "type": "string",
+          "description": "Shorthand: agent ID"
+        },
+        { "$ref": "#/$defs/DirectAddress" },
+        { "$ref": "#/$defs/MultiAddress" },
+        { "$ref": "#/$defs/ScopeAddress" },
+        { "$ref": "#/$defs/RoleAddress" },
+        { "$ref": "#/$defs/HierarchicalAddress" },
+        { "$ref": "#/$defs/BroadcastAddress" },
+        { "$ref": "#/$defs/SystemAddress" },
+        { "$ref": "#/$defs/ParticipantAddress" },
+        { "$ref": "#/$defs/FederatedAddress" }
+      ]
+    },
+    "DirectAddress": {
+      "type": "object",
+      "description": "Address a single agent directly",
+      "properties": {
+        "agent": { "$ref": "#/$defs/AgentId" }
+      },
+      "required": ["agent"],
+      "additionalProperties": false
+    },
+    "MultiAddress": {
+      "type": "object",
+      "description": "Address multiple agents",
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/AgentId" },
+          "minItems": 1
+        }
+      },
+      "required": ["agents"],
+      "additionalProperties": false
+    },
+    "ScopeAddress": {
+      "type": "object",
+      "description": "Address all agents in a scope",
+      "properties": {
+        "scope": { "$ref": "#/$defs/ScopeId" }
+      },
+      "required": ["scope"],
+      "additionalProperties": false
+    },
+    "RoleAddress": {
+      "type": "object",
+      "description": "Address agents by role, optionally within a scope",
+      "properties": {
+        "role": { "type": "string" },
+        "within": { "$ref": "#/$defs/ScopeId" }
+      },
+      "required": ["role"],
+      "additionalProperties": false
+    },
+    "HierarchicalAddress": {
+      "type": "object",
+      "description": "Address relative to sender in hierarchy",
+      "properties": {
+        "parent": {
+          "type": "boolean",
+          "const": true,
+          "description": "Address sender's parent"
+        },
+        "children": {
+          "type": "boolean",
+          "const": true,
+          "description": "Address sender's children"
+        },
+        "ancestors": {
+          "type": "boolean",
+          "const": true,
+          "description": "Address ancestors up the tree"
+        },
+        "descendants": {
+          "type": "boolean",
+          "const": true,
+          "description": "Address descendants down the tree"
+        },
+        "siblings": {
+          "type": "boolean",
+          "const": true,
+          "description": "Address agents with same parent"
+        },
+        "depth": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Limit depth for children/ancestors/descendants"
+        }
+      },
+      "oneOf": [
+        { "required": ["parent"] },
+        { "required": ["children"] },
+        { "required": ["ancestors"] },
+        { "required": ["descendants"] },
+        { "required": ["siblings"] }
+      ],
+      "additionalProperties": false
+    },
+    "BroadcastAddress": {
+      "type": "object",
+      "description": "Address all agents in the system",
+      "properties": {
+        "broadcast": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "required": ["broadcast"],
+      "additionalProperties": false
+    },
+    "SystemAddress": {
+      "type": "object",
+      "description": "Address the system/router itself",
+      "properties": {
+        "system": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "required": ["system"],
+      "additionalProperties": false
+    },
+    "ParticipantAddress": {
+      "type": "object",
+      "description": "Address any participant by ID or category",
+      "properties": {
+        "participant": { "$ref": "#/$defs/ParticipantId" },
+        "participants": {
+          "type": "string",
+          "enum": ["all", "agents", "clients"]
+        }
+      },
+      "oneOf": [
+        { "required": ["participant"] },
+        { "required": ["participants"] }
+      ],
+      "additionalProperties": false
+    },
+    "FederatedAddress": {
+      "type": "object",
+      "description": "Address an agent in a federated system",
+      "properties": {
+        "system": {
+          "type": "string",
+          "description": "Target system identifier"
+        },
+        "agent": { "$ref": "#/$defs/AgentId" }
+      },
+      "required": ["system", "agent"],
+      "additionalProperties": false
+    },
+
+    "MessagePriority": {
+      "type": "string",
+      "enum": ["urgent", "high", "normal", "low"],
+      "default": "normal"
+    },
+    "DeliverySemantics": {
+      "type": "string",
+      "enum": ["fire-and-forget", "acknowledged", "guaranteed"],
+      "default": "fire-and-forget",
+      "description": "Message delivery guarantees"
+    },
+    "MessageRelationship": {
+      "type": "string",
+      "enum": ["parent-to-child", "child-to-parent", "peer", "broadcast"],
+      "description": "Relationship context for the message"
+    },
+    "MessageMeta": {
+      "type": "object",
+      "description": "Metadata for a message",
+      "properties": {
+        "timestamp": { "$ref": "#/$defs/Timestamp" },
+        "relationship": { "$ref": "#/$defs/MessageRelationship" },
+        "expectsResponse": { "type": "boolean" },
+        "correlationId": { "$ref": "#/$defs/CorrelationId" },
+        "isResult": { "type": "boolean" },
+        "priority": { "$ref": "#/$defs/MessagePriority" },
+        "delivery": { "$ref": "#/$defs/DeliverySemantics" },
+        "ttlMs": {
+          "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
+    },
+    "Message": {
+      "type": "object",
+      "description": "A message in the multi-agent system",
+      "properties": {
+        "id": { "$ref": "#/$defs/MessageId" },
+        "from": { "$ref": "#/$defs/ParticipantId" },
+        "to": { "$ref": "#/$defs/Address" },
+        "payload": {
+          "description": "Message payload - structure depends on use case"
+        },
+        "meta": { "$ref": "#/$defs/MessageMeta" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "from", "to"],
+      "additionalProperties": false
+    },
+
+    "JoinPolicy": {
+      "type": "string",
+      "enum": ["open", "invite", "role", "system"],
+      "description": "Policy for joining a scope"
+    },
+    "ScopeVisibility": {
+      "type": "string",
+      "enum": ["public", "members", "system"],
+      "description": "Who can see the scope exists and its members"
+    },
+    "MessageVisibility": {
+      "type": "string",
+      "enum": ["public", "members", "system"],
+      "description": "Who can see messages sent to this scope"
+    },
+    "SendPolicy": {
+      "type": "string",
+      "enum": ["members", "any"],
+      "description": "Who can send messages to this scope"
+    },
+    "Scope": {
+      "type": "object",
+      "description": "A scope for grouping agents",
+      "properties": {
+        "id": { "$ref": "#/$defs/ScopeId" },
+        "name": { "type": "string" },
+        "description": { "type": "string" },
+        "parent": { "$ref": "#/$defs/ScopeId" },
+        "joinPolicy": { "$ref": "#/$defs/JoinPolicy" },
+        "autoJoinRoles": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Roles that auto-join this scope"
+        },
+        "visibility": { "$ref": "#/$defs/ScopeVisibility" },
+        "messageVisibility": { "$ref": "#/$defs/MessageVisibility" },
+        "sendPolicy": { "$ref": "#/$defs/SendPolicy" },
+        "persistent": {
+          "type": "boolean",
+          "default": true,
+          "description": "Survives system restart"
+        },
+        "autoDelete": {
+          "type": "boolean",
+          "default": false,
+          "description": "Delete when empty"
+        },
+        "metadata": { "type": "object" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id"],
+      "additionalProperties": false
+    },
+
+    "EventType": {
+      "type": "string",
+      "enum": [
+        "agent_registered",
+        "agent_state_changed",
+        "agent_environment_changed",
+        "agent_unregistered",
+        "message_sent",
+        "message_delivered",
+        "message_failed",
+        "scope_created",
+        "scope_deleted",
+        "scope_member_joined",
+        "scope_member_left",
+        "system_error",
+        "federation_connected",
+        "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"
+    },
+    "Event": {
+      "type": "object",
+      "description": "A system event",
+      "properties": {
+        "id": { "type": "string" },
+        "type": { "$ref": "#/$defs/EventType" },
+        "timestamp": { "$ref": "#/$defs/Timestamp" },
+        "source": { "$ref": "#/$defs/ParticipantId" },
+        "data": {
+          "type": "object",
+          "description": "Event-specific data"
+        },
+        "causedBy": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "IDs of events that caused this one (causal ordering)"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "type", "timestamp"],
+      "additionalProperties": false
+    },
+    "SubscriptionFilter": {
+      "type": "object",
+      "description": "Filter for event subscriptions",
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/AgentId" },
+          "description": "Only events from these agents"
+        },
+        "roles": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Only events from agents with these roles"
+        },
+        "scopes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ScopeId" },
+          "description": "Only events in these scopes"
+        },
+        "eventTypes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/EventType" },
+          "description": "Only these event types"
+        },
+        "priorities": {
+          "type": "array",
+          "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
+    },
+    "Subscription": {
+      "type": "object",
+      "description": "An active event subscription",
+      "properties": {
+        "id": { "$ref": "#/$defs/SubscriptionId" },
+        "filter": { "$ref": "#/$defs/SubscriptionFilter" },
+        "createdAt": { "$ref": "#/$defs/Timestamp" },
+        "replayFrom": {
+          "oneOf": [
+            { "$ref": "#/$defs/Timestamp" },
+            { "type": "string", "description": "Event ID to replay from" }
+          ],
+          "description": "Replay missed events from this point"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id"],
+      "additionalProperties": false
+    },
+
+    "ConnectRequest": {
+      "type": "object",
+      "x-method": "map/connect",
+      "x-tier": "core",
+      "description": "Connect to the MAP system and negotiate capabilities",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/connect" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "protocolVersion": { "$ref": "#/$defs/ProtocolVersion" },
+            "participantType": { "$ref": "#/$defs/ParticipantType" },
+            "participantId": { "$ref": "#/$defs/ParticipantId" },
+            "name": { "type": "string" },
+            "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+            "sessionId": {
+              "$ref": "#/$defs/SessionId",
+              "description": "Optional session to reconnect to"
+            },
+            "auth": {
+              "type": "object",
+              "properties": {
+                "method": {
+                  "type": "string",
+                  "oneOf": [
+                    { "enum": ["bearer", "api-key", "mtls", "none"] },
+                    { "type": "string", "pattern": "^x-" }
+                  ]
+                },
+                "token": { "type": "string" }
+              }
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["protocolVersion", "participantType"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "ConnectResponse": {
+      "type": "object",
+      "description": "Response to map/connect",
+      "properties": {
+        "protocolVersion": { "$ref": "#/$defs/ProtocolVersion" },
+        "sessionId": { "$ref": "#/$defs/SessionId" },
+        "participantId": { "$ref": "#/$defs/ParticipantId" },
+        "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+        "systemInfo": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "version": { "type": "string" }
+          }
+        },
+        "serverEnvironment": {
+          "$ref": "#/$defs/AgentEnvironment",
+          "description": "Server's compute environment (if relevant)"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["protocolVersion", "sessionId", "participantId", "capabilities"]
+    },
+    "DisconnectRequest": {
+      "type": "object",
+      "x-method": "map/disconnect",
+      "x-tier": "core",
+      "description": "Gracefully disconnect from the MAP system",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/disconnect" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "reason": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "DisconnectResponse": {
+      "type": "object",
+      "description": "Response to map/disconnect",
+      "properties": {
+        "acknowledged": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["acknowledged"]
+    },
+
+    "SessionListRequest": {
+      "type": "object",
+      "x-method": "map/session/list",
+      "x-tier": "core",
+      "description": "List participant's sessions",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/session/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "SessionListResponse": {
+      "type": "object",
+      "description": "Response to map/session/list",
+      "properties": {
+        "sessions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": { "$ref": "#/$defs/SessionId" },
+              "createdAt": { "$ref": "#/$defs/Timestamp" },
+              "lastActiveAt": { "$ref": "#/$defs/Timestamp" }
+            },
+            "required": ["id", "createdAt"]
+          }
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["sessions"]
+    },
+    "SessionLoadRequest": {
+      "type": "object",
+      "x-method": "map/session/load",
+      "x-tier": "core",
+      "description": "Load/reconnect to an existing session",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/session/load" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "sessionId": { "$ref": "#/$defs/SessionId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["sessionId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "SessionLoadResponse": {
+      "type": "object",
+      "description": "Response to map/session/load",
+      "properties": {
+        "sessionId": { "$ref": "#/$defs/SessionId" },
+        "restored": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["sessionId", "restored"]
+    },
+    "SessionCloseRequest": {
+      "type": "object",
+      "x-method": "map/session/close",
+      "x-tier": "core",
+      "description": "Explicitly end a session",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/session/close" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "sessionId": { "$ref": "#/$defs/SessionId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "SessionCloseResponse": {
+      "type": "object",
+      "description": "Response to map/session/close",
+      "properties": {
+        "closed": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["closed"]
+    },
+
+    "AgentsListRequest": {
+      "type": "object",
+      "x-method": "map/agents/list",
+      "x-tier": "core",
+      "description": "List agents with optional filters",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "filter": {
+              "type": "object",
+              "properties": {
+                "states": {
+                  "type": "array",
+                  "items": { "$ref": "#/$defs/AgentState" }
+                },
+                "roles": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                },
+                "scopes": {
+                  "type": "array",
+                  "items": { "$ref": "#/$defs/ScopeId" }
+                },
+                "parent": { "$ref": "#/$defs/AgentId" },
+                "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 },
+            "cursor": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "AgentsListResponse": {
+      "type": "object",
+      "description": "Response to map/agents/list",
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/Agent" }
+        },
+        "nextCursor": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["agents"]
+    },
+    "AgentsGetRequest": {
+      "type": "object",
+      "x-method": "map/agents/get",
+      "x-tier": "core",
+      "description": "Get details for a single agent",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/get" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AgentsGetResponse": {
+      "type": "object",
+      "description": "Response to map/agents/get",
+      "properties": {
+        "agent": { "$ref": "#/$defs/Agent" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["agent"]
+    },
+
+    "SendRequest": {
+      "type": "object",
+      "x-method": "map/send",
+      "x-tier": "core",
+      "description": "Send a message to an address",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/send" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "to": { "$ref": "#/$defs/Address" },
+            "payload": {},
+            "meta": { "$ref": "#/$defs/MessageMeta" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["to"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "SendResponse": {
+      "type": "object",
+      "description": "Response to map/send",
+      "properties": {
+        "messageId": { "$ref": "#/$defs/MessageId" },
+        "delivered": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ParticipantId" },
+          "description": "Participants the message was delivered to"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["messageId"]
+    },
+
+    "SubscribeRequest": {
+      "type": "object",
+      "x-method": "map/subscribe",
+      "x-tier": "core",
+      "description": "Subscribe to event streams",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/subscribe" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "filter": { "$ref": "#/$defs/SubscriptionFilter" },
+            "replayFrom": {
+              "oneOf": [
+                { "$ref": "#/$defs/Timestamp" },
+                { "type": "string" }
+              ]
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "SubscribeResponse": {
+      "type": "object",
+      "description": "Response to map/subscribe",
+      "properties": {
+        "subscriptionId": { "$ref": "#/$defs/SubscriptionId" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["subscriptionId"]
+    },
+    "UnsubscribeRequest": {
+      "type": "object",
+      "x-method": "map/unsubscribe",
+      "x-tier": "core",
+      "description": "Unsubscribe from event streams",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/unsubscribe" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "subscriptionId": { "$ref": "#/$defs/SubscriptionId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["subscriptionId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "UnsubscribeResponse": {
+      "type": "object",
+      "description": "Response to map/unsubscribe",
+      "properties": {
+        "unsubscribed": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["unsubscribed"]
+    },
+
+    "AuthRefreshRequest": {
+      "type": "object",
+      "x-method": "map/auth/refresh",
+      "x-tier": "core",
+      "description": "Refresh authentication token in-band",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/auth/refresh" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "refreshToken": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["refreshToken"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AuthRefreshResponse": {
+      "type": "object",
+      "description": "Response to map/auth/refresh",
+      "properties": {
+        "accessToken": { "type": "string" },
+        "expiresAt": { "$ref": "#/$defs/Timestamp" },
+        "refreshToken": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["accessToken", "expiresAt"]
+    },
+
+    "AgentsRegisterRequest": {
+      "type": "object",
+      "x-method": "map/agents/register",
+      "x-tier": "structure",
+      "description": "Register a new agent in the system",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/register" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "name": { "type": "string" },
+            "description": { "type": "string" },
+            "role": { "type": "string" },
+            "parent": { "$ref": "#/$defs/AgentId" },
+            "scopes": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/ScopeId" }
+            },
+            "visibility": { "$ref": "#/$defs/AgentVisibility" },
+            "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+            "capabilityDescriptor": { "$ref": "#/$defs/MAPAgentCapabilityDescriptor" },
+            "environment": { "$ref": "#/$defs/AgentEnvironment" },
+            "metadata": { "type": "object" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "AgentsRegisterResponse": {
+      "type": "object",
+      "description": "Response to map/agents/register",
+      "properties": {
+        "agent": { "$ref": "#/$defs/Agent" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["agent"]
+    },
+    "AgentsSpawnRequest": {
+      "type": "object",
+      "x-method": "map/agents/spawn",
+      "x-tier": "structure",
+      "description": "Register agent and assign initial task atomically",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/spawn" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "name": { "type": "string" },
+            "description": { "type": "string" },
+            "role": { "type": "string" },
+            "parent": { "$ref": "#/$defs/AgentId" },
+            "scopes": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/ScopeId" }
+            },
+            "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" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "AgentsSpawnResponse": {
+      "type": "object",
+      "description": "Response to map/agents/spawn",
+      "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"]
+    },
+    "AgentsUnregisterRequest": {
+      "type": "object",
+      "x-method": "map/agents/unregister",
+      "x-tier": "structure",
+      "description": "Remove an agent from the system",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/unregister" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "reason": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AgentsUnregisterResponse": {
+      "type": "object",
+      "description": "Response to map/agents/unregister",
+      "properties": {
+        "unregistered": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["unregistered"]
+    },
+    "AgentsUpdateRequest": {
+      "type": "object",
+      "x-method": "map/agents/update",
+      "x-tier": "structure",
+      "description": "Update agent state or metadata",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/update" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "state": { "$ref": "#/$defs/AgentState" },
+            "metadata": { "type": "object" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AgentsUpdateResponse": {
+      "type": "object",
+      "description": "Response to map/agents/update",
+      "properties": {
+        "agent": { "$ref": "#/$defs/Agent" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["agent"]
+    },
+    "AgentsStopRequest": {
+      "type": "object",
+      "x-method": "map/agents/stop",
+      "x-tier": "structure",
+      "description": "Request graceful agent stop",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/stop" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "reason": { "type": "string" },
+            "force": { "type": "boolean", "default": false },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AgentsStopResponse": {
+      "type": "object",
+      "description": "Response to map/agents/stop",
+      "properties": {
+        "stopping": { "type": "boolean" },
+        "agent": { "$ref": "#/$defs/Agent" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["stopping"]
+    },
+    "AgentsSuspendRequest": {
+      "type": "object",
+      "x-method": "map/agents/suspend",
+      "x-tier": "structure",
+      "description": "Pause an agent",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/suspend" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "reason": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AgentsSuspendResponse": {
+      "type": "object",
+      "description": "Response to map/agents/suspend",
+      "properties": {
+        "suspended": { "type": "boolean" },
+        "agent": { "$ref": "#/$defs/Agent" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["suspended"]
+    },
+    "AgentsResumeRequest": {
+      "type": "object",
+      "x-method": "map/agents/resume",
+      "x-tier": "structure",
+      "description": "Resume a suspended agent",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/agents/resume" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "AgentsResumeResponse": {
+      "type": "object",
+      "description": "Response to map/agents/resume",
+      "properties": {
+        "resumed": { "type": "boolean" },
+        "agent": { "$ref": "#/$defs/Agent" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["resumed"]
+    },
+
+    "StructureGraphRequest": {
+      "type": "object",
+      "x-method": "map/structure/graph",
+      "x-tier": "structure",
+      "description": "Get the agent relationship graph",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/structure/graph" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "rootAgentId": { "$ref": "#/$defs/AgentId" },
+            "depth": { "type": "integer", "minimum": 1 },
+            "includeRelationships": { "type": "boolean", "default": true },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "StructureGraphResponse": {
+      "type": "object",
+      "description": "Response to map/structure/graph",
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/Agent" }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "from": { "$ref": "#/$defs/AgentId" },
+              "to": { "$ref": "#/$defs/AgentId" },
+              "type": {
+                "type": "string",
+                "enum": ["parent-child", "peer", "supervisor", "collaborator"]
+              }
+            },
+            "required": ["from", "to", "type"]
+          }
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["nodes", "edges"]
+    },
+
+    "ScopesListRequest": {
+      "type": "object",
+      "x-method": "map/scopes/list",
+      "x-tier": "structure",
+      "description": "List all scopes",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "parent": { "$ref": "#/$defs/ScopeId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "ScopesListResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/list",
+      "properties": {
+        "scopes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/Scope" }
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["scopes"]
+    },
+    "ScopesGetRequest": {
+      "type": "object",
+      "x-method": "map/scopes/get",
+      "x-tier": "structure",
+      "description": "Get details for a single scope",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/get" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/ScopeId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["scopeId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "ScopesGetResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/get",
+      "properties": {
+        "scope": { "$ref": "#/$defs/Scope" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["scope"]
+    },
+    "ScopesCreateRequest": {
+      "type": "object",
+      "x-method": "map/scopes/create",
+      "x-tier": "structure",
+      "description": "Create a new scope",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/create" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/ScopeId" },
+            "name": { "type": "string" },
+            "description": { "type": "string" },
+            "parent": { "$ref": "#/$defs/ScopeId" },
+            "joinPolicy": { "$ref": "#/$defs/JoinPolicy" },
+            "autoJoinRoles": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "visibility": { "$ref": "#/$defs/ScopeVisibility" },
+            "messageVisibility": { "$ref": "#/$defs/MessageVisibility" },
+            "sendPolicy": { "$ref": "#/$defs/SendPolicy" },
+            "persistent": { "type": "boolean" },
+            "autoDelete": { "type": "boolean" },
+            "metadata": { "type": "object" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "ScopesCreateResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/create",
+      "properties": {
+        "scope": { "$ref": "#/$defs/Scope" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["scope"]
+    },
+    "ScopesDeleteRequest": {
+      "type": "object",
+      "x-method": "map/scopes/delete",
+      "x-tier": "structure",
+      "description": "Delete a scope",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/delete" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/ScopeId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["scopeId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "ScopesDeleteResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/delete",
+      "properties": {
+        "deleted": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["deleted"]
+    },
+    "ScopesJoinRequest": {
+      "type": "object",
+      "x-method": "map/scopes/join",
+      "x-tier": "structure",
+      "description": "Add an agent to a scope",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/join" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/ScopeId" },
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["scopeId", "agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "ScopesJoinResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/join",
+      "properties": {
+        "joined": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["joined"]
+    },
+    "ScopesLeaveRequest": {
+      "type": "object",
+      "x-method": "map/scopes/leave",
+      "x-tier": "structure",
+      "description": "Remove an agent from a scope",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/leave" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/ScopeId" },
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["scopeId", "agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "ScopesLeaveResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/leave",
+      "properties": {
+        "left": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["left"]
+    },
+    "ScopesMembersRequest": {
+      "type": "object",
+      "x-method": "map/scopes/members",
+      "x-tier": "structure",
+      "description": "List members of a scope",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/scopes/members" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/ScopeId" },
+            "limit": { "type": "integer", "minimum": 1 },
+            "cursor": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["scopeId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "ScopesMembersResponse": {
+      "type": "object",
+      "description": "Response to map/scopes/members",
+      "properties": {
+        "members": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/AgentId" }
+        },
+        "nextCursor": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["members"]
+    },
+
+    "InjectRequest": {
+      "type": "object",
+      "x-method": "map/inject",
+      "x-tier": "extension",
+      "description": "Inject context into a running agent (steering)",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/inject" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "content": {
+              "description": "Content to inject"
+            },
+            "delivery": {
+              "type": "string",
+              "enum": ["interrupt", "queue", "best-effort"],
+              "default": "best-effort",
+              "description": "How to deliver the injection"
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId", "content"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "InjectResponse": {
+      "type": "object",
+      "description": "Response to map/inject",
+      "properties": {
+        "injected": { "type": "boolean" },
+        "delivery": {
+          "type": "string",
+          "enum": ["interrupt", "queue", "message"],
+          "description": "Actual delivery method used"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["injected"]
+    },
+
+    "FederationConnectRequest": {
+      "type": "object",
+      "x-method": "map/federation/connect",
+      "x-tier": "extension",
+      "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" },
+        "method": { "const": "map/federation/connect" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "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": {
+                "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" }
+          },
+          "required": ["systemId", "endpoint"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "FederationConnectResponse": {
+      "type": "object",
+      "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": {
+            "name": { "type": "string" },
+            "version": { "type": "string" },
+            "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" }
+          }
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["connected"]
+    },
+    "FederationRouteRequest": {
+      "type": "object",
+      "x-method": "map/federation/route",
+      "x-tier": "extension",
+      "description": "Route a message to a federated system",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "map/federation/route" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "systemId": { "type": "string" },
+            "message": { "$ref": "#/$defs/Message" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["systemId", "message"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "FederationRouteResponse": {
+      "type": "object",
+      "description": "Response to map/federation/route",
+      "properties": {
+        "routed": { "type": "boolean" },
+        "messageId": { "$ref": "#/$defs/MessageId" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["routed"]
+    },
+
+    "EventNotification": {
+      "type": "object",
+      "x-method": "map/event",
+      "description": "System event notification (sent to subscribers)",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "method": { "const": "map/event" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "subscriptionId": { "$ref": "#/$defs/SubscriptionId" },
+            "sequenceNumber": {
+              "type": "integer",
+              "description": "Monotonic sequence for ordering"
+            },
+            "event": { "$ref": "#/$defs/Event" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["subscriptionId", "sequenceNumber", "event"]
+        }
+      },
+      "required": ["jsonrpc", "method", "params"]
+    },
+    "MessageNotification": {
+      "type": "object",
+      "x-method": "map/message",
+      "description": "Message delivery notification",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "method": { "const": "map/message" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "message": { "$ref": "#/$defs/Message" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["message"]
+        }
+      },
+      "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"]
+    }
+  }
+}