multi-agent-protocol 0.0.1 → 0.0.2

package/schema/meta.json

@@ -0,0 +1,337 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Multi-Agent Protocol Method Metadata",
+  "description": "Metadata for MAP protocol methods including tier, implementer, and capability requirements",
+  "protocolVersion": 1,
+  "methods": {
+    "map/connect": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": [],
+      "description": "Connect to the MAP system and negotiate capabilities",
+      "requestType": "ConnectRequest",
+      "responseType": "ConnectResponse"
+    },
+    "map/disconnect": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": [],
+      "description": "Gracefully disconnect from the MAP system",
+      "requestType": "DisconnectRequest",
+      "responseType": "DisconnectResponse"
+    },
+    "map/session/list": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": [],
+      "description": "List participant's sessions",
+      "requestType": "SessionListRequest",
+      "responseType": "SessionListResponse"
+    },
+    "map/session/load": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": [],
+      "description": "Load/reconnect to an existing session",
+      "requestType": "SessionLoadRequest",
+      "responseType": "SessionLoadResponse"
+    },
+    "map/session/close": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": [],
+      "description": "Explicitly end a session",
+      "requestType": "SessionCloseRequest",
+      "responseType": "SessionCloseResponse"
+    },
+    "map/agents/list": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": ["observation.canQuery"],
+      "description": "List agents with optional filters (server-filtered by visibility)",
+      "requestType": "AgentsListRequest",
+      "responseType": "AgentsListResponse"
+    },
+    "map/agents/get": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": ["observation.canQuery"],
+      "description": "Get details for a single agent",
+      "requestType": "AgentsGetRequest",
+      "responseType": "AgentsGetResponse"
+    },
+    "map/send": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["messaging.canSend"],
+      "description": "Send a message to an address",
+      "requestType": "SendRequest",
+      "responseType": "SendResponse"
+    },
+    "map/subscribe": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": ["observation.canObserve"],
+      "description": "Subscribe to event streams",
+      "requestType": "SubscribeRequest",
+      "responseType": "SubscribeResponse"
+    },
+    "map/unsubscribe": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": ["observation.canObserve"],
+      "description": "Unsubscribe from event streams",
+      "requestType": "UnsubscribeRequest",
+      "responseType": "UnsubscribeResponse"
+    },
+    "map/auth/refresh": {
+      "tier": "core",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "gateway"],
+      "capabilities": [],
+      "description": "Refresh authentication token in-band",
+      "requestType": "AuthRefreshRequest",
+      "responseType": "AuthRefreshResponse"
+    },
+    "map/agents/register": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": ["lifecycle.canRegister"],
+      "description": "Register a new agent in the system",
+      "requestType": "AgentsRegisterRequest",
+      "responseType": "AgentsRegisterResponse"
+    },
+    "map/agents/spawn": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": ["lifecycle.canSpawn"],
+      "description": "Register agent and assign initial task atomically",
+      "requestType": "AgentsSpawnRequest",
+      "responseType": "AgentsSpawnResponse"
+    },
+    "map/agents/unregister": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": ["lifecycle.canUnregister"],
+      "description": "Remove an agent from the system",
+      "requestType": "AgentsUnregisterRequest",
+      "responseType": "AgentsUnregisterResponse"
+    },
+    "map/agents/update": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": [],
+      "description": "Update agent state or metadata (agents can update themselves)",
+      "requestType": "AgentsUpdateRequest",
+      "responseType": "AgentsUpdateResponse"
+    },
+    "map/agents/stop": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "system"],
+      "capabilities": ["lifecycle.canStop"],
+      "description": "Request graceful agent stop",
+      "requestType": "AgentsStopRequest",
+      "responseType": "AgentsStopResponse"
+    },
+    "map/agents/suspend": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "system"],
+      "capabilities": ["lifecycle.canStop"],
+      "description": "Pause an agent",
+      "requestType": "AgentsSuspendRequest",
+      "responseType": "AgentsSuspendResponse"
+    },
+    "map/agents/resume": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent", "system"],
+      "capabilities": ["lifecycle.canStop"],
+      "description": "Resume a suspended agent",
+      "requestType": "AgentsResumeRequest",
+      "responseType": "AgentsResumeResponse"
+    },
+    "map/structure/graph": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["observation.canQuery"],
+      "description": "Get the agent relationship graph",
+      "requestType": "StructureGraphRequest",
+      "responseType": "StructureGraphResponse"
+    },
+    "map/scopes/list": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["observation.canQuery"],
+      "description": "List all scopes",
+      "requestType": "ScopesListRequest",
+      "responseType": "ScopesListResponse"
+    },
+    "map/scopes/get": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["observation.canQuery"],
+      "description": "Get details for a single scope",
+      "requestType": "ScopesGetRequest",
+      "responseType": "ScopesGetResponse"
+    },
+    "map/scopes/create": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": ["scopes.canCreateScopes"],
+      "description": "Create a new scope",
+      "requestType": "ScopesCreateRequest",
+      "responseType": "ScopesCreateResponse"
+    },
+    "map/scopes/delete": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": ["scopes.canManageScopes"],
+      "description": "Delete a scope",
+      "requestType": "ScopesDeleteRequest",
+      "responseType": "ScopesDeleteResponse"
+    },
+    "map/scopes/join": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": [],
+      "description": "Add an agent to a scope",
+      "requestType": "ScopesJoinRequest",
+      "responseType": "ScopesJoinResponse"
+    },
+    "map/scopes/leave": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": [],
+      "description": "Remove an agent from a scope",
+      "requestType": "ScopesLeaveRequest",
+      "responseType": "ScopesLeaveResponse"
+    },
+    "map/scopes/members": {
+      "tier": "structure",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["observation.canQuery"],
+      "description": "List members of a scope",
+      "requestType": "ScopesMembersRequest",
+      "responseType": "ScopesMembersResponse"
+    },
+    "map/inject": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["lifecycle.canSteer"],
+      "description": "Inject context into a running agent (steering)",
+      "requestType": "InjectRequest",
+      "responseType": "InjectResponse"
+    },
+    "map/federation/connect": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["system"],
+      "capabilities": [],
+      "description": "Connect to a peer MAP system",
+      "requestType": "FederationConnectRequest",
+      "responseType": "FederationConnectResponse"
+    },
+    "map/federation/route": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["agent", "system"],
+      "capabilities": ["messaging.canSend"],
+      "description": "Route a message to a federated system",
+      "requestType": "FederationRouteRequest",
+      "responseType": "FederationRouteResponse"
+    }
+  },
+  "notifications": {
+    "map/event": {
+      "tier": "core",
+      "direction": "system-to-participant",
+      "description": "System event notification (sent to subscribers)",
+      "paramsType": "EventNotification"
+    },
+    "map/message": {
+      "tier": "core",
+      "direction": "system-to-participant",
+      "description": "Message delivery notification",
+      "paramsType": "MessageNotification"
+    }
+  },
+  "errorCodes": {
+    "protocol": {
+      "-32700": "Parse error",
+      "-32600": "Invalid request",
+      "-32601": "Method not found",
+      "-32602": "Invalid params",
+      "-32603": "Internal error"
+    },
+    "auth": {
+      "1000": "Authentication required",
+      "1001": "Authentication failed",
+      "1002": "Token expired",
+      "1003": "Insufficient permissions"
+    },
+    "routing": {
+      "2000": "Address not found",
+      "2001": "Agent not found",
+      "2002": "Scope not found",
+      "2003": "Delivery failed",
+      "2004": "Address ambiguous"
+    },
+    "agent": {
+      "3000": "Agent already exists",
+      "3001": "Agent state invalid",
+      "3002": "Agent not responding",
+      "3003": "Agent terminated",
+      "3004": "Spawn failed"
+    },
+    "resource": {
+      "4000": "Resource exhausted",
+      "4001": "Rate limited",
+      "4002": "Quota exceeded"
+    },
+    "federation": {
+      "5000": "Federation unavailable",
+      "5001": "System not found",
+      "5002": "Federation auth failed",
+      "5003": "Route rejected"
+    }
+  },
+  "tiers": {
+    "core": {
+      "description": "Required methods for basic MAP functionality",
+      "required": true
+    },
+    "structure": {
+      "description": "Methods for agent lifecycle and system structure management",
+      "required": false
+    },
+    "extension": {
+      "description": "Optional extension methods for advanced features",
+      "required": false
+    }
+  }
+}