macro-agent 0.0.14 → 0.0.16

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

@@ -0,0 +1,56 @@
+{
+  "name": "multi-agent-protocol",
+  "version": "0.0.4",
+  "description": "Multi-Agent Protocol (MAP) - A protocol for observing, coordinating, and routing messages within multi-agent AI systems",
+  "type": "module",
+  "main": "./schema/schema.json",
+  "exports": {
+    ".": "./schema/schema.json",
+    "./schema": "./schema/schema.json",
+    "./meta": "./schema/meta.json"
+  },
+  "files": [
+    "schema",
+    "docs",
+    "README.md"
+  ],
+  "workspaces": [
+    "ts-sdk"
+  ],
+  "scripts": {
+    "build": "npm run build --workspace=ts-sdk",
+    "test": "npm run test --workspace=ts-sdk",
+    "typecheck": "npm run typecheck --workspace=ts-sdk",
+    "publish:npm": "npm publish --access public",
+    "prepublishOnly": "npm run build",
+    "version:patch": "npm version patch && git push && git push --tags",
+    "version:minor": "npm version minor && git push && git push --tags",
+    "version:major": "npm version major && git push && git push --tags"
+  },
+  "keywords": [
+    "multi-agent",
+    "agent",
+    "protocol",
+    "map",
+    "swarm",
+    "messaging",
+    "json-schema",
+    "specification"
+  ],
+  "author": "Alex Ngai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/multi-agent-protocol/multi-agent-protocol.git"
+  },
+  "bugs": {
+    "url": "https://github.com/multi-agent-protocol/multi-agent-protocol/issues"
+  },
+  "homepage": "https://github.com/multi-agent-protocol/multi-agent-protocol#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

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

@@ -0,0 +1,467 @@
+{
+  "$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"
+    },
+    "mail/create": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canCreate"],
+      "description": "Create a new conversation with optional initial participants and turn",
+      "requestType": "MailCreateRequest",
+      "responseType": "MailCreateResponse"
+    },
+    "mail/get": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canViewHistory"],
+      "description": "Get conversation details with optional includes (participants, threads, recent turns, stats)",
+      "requestType": "MailGetRequest",
+      "responseType": "MailGetResponse"
+    },
+    "mail/list": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canViewHistory"],
+      "description": "List conversations with filtering by type, status, participant, and time range",
+      "requestType": "MailListRequest",
+      "responseType": "MailListResponse"
+    },
+    "mail/close": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": [],
+      "description": "Close a conversation (must be a participant)",
+      "requestType": "MailCloseRequest",
+      "responseType": "MailCloseResponse"
+    },
+    "mail/join": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canJoin"],
+      "description": "Join a conversation with optional catch-up history",
+      "requestType": "MailJoinRequest",
+      "responseType": "MailJoinResponse"
+    },
+    "mail/leave": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": [],
+      "description": "Leave a conversation (must be a participant)",
+      "requestType": "MailLeaveRequest",
+      "responseType": "MailLeaveResponse"
+    },
+    "mail/invite": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canInvite"],
+      "description": "Invite a participant to a conversation",
+      "requestType": "MailInviteRequest",
+      "responseType": "MailInviteResponse"
+    },
+    "mail/turn": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": [],
+      "description": "Record a turn in a conversation (must be a participant)",
+      "requestType": "MailTurnRequest",
+      "responseType": "MailTurnResponse"
+    },
+    "mail/turns/list": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canViewHistory"],
+      "description": "List turns in a conversation with filtering and pagination",
+      "requestType": "MailTurnsListRequest",
+      "responseType": "MailTurnsListResponse"
+    },
+    "mail/thread/create": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canCreateThreads"],
+      "description": "Create a thread rooted at a specific turn",
+      "requestType": "MailThreadCreateRequest",
+      "responseType": "MailThreadCreateResponse"
+    },
+    "mail/thread/list": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canViewHistory"],
+      "description": "List threads in a conversation",
+      "requestType": "MailThreadListRequest",
+      "responseType": "MailThreadListResponse"
+    },
+    "mail/summary": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canViewHistory"],
+      "description": "Get or generate a summary for a conversation",
+      "requestType": "MailSummaryRequest",
+      "responseType": "MailSummaryResponse"
+    },
+    "mail/replay": {
+      "tier": "extension",
+      "implementedBy": "system",
+      "callableBy": ["client", "agent"],
+      "capabilities": ["mail.canViewHistory"],
+      "description": "Replay conversation turns from a specific point",
+      "requestType": "MailReplayRequest",
+      "responseType": "MailReplayResponse"
+    }
+  },
+  "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"
+    },
+    "mail": {
+      "10000": "Conversation not found",
+      "10001": "Conversation closed",
+      "10002": "Not a participant",
+      "10003": "Mail permission denied",
+      "10004": "Participant already joined",
+      "10005": "Participant not found",
+      "10006": "Turn not found",
+      "10007": "Thread not found",
+      "10008": "Invalid content type",
+      "10009": "Thread nesting limit exceeded",
+      "10010": "Mail not enabled"
+    }
+  },
+  "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
+    }
+  }
+}