@multi-agent-protocol/sdk 0.0.4 → 0.0.6

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { R as RequestId, M as MAPError, a as MAPErrorData, E as ErrorCategory, F as FederationBufferConfig, b as FederationEnvelope, c as Message, S as Stream, B as BaseConnectionOptions, P as ParticipantCapabilities, d as FederationRoutingConfig, e as EventType, C as ConnectResponseResult, f as SessionId, g as FederationConnectResponseResult, h as FederationRouteResponseResult, i as ConnectionState, j as ParticipantId, k as ParticipantType, A as AgentId, l as ScopeId, m as Agent, n as Scope, o as Address, p as SubscriptionFilter, q as Event, r as AgentsGetResponseResult, s as AgentsListResponseResult, t as AgentsRegisterResponseResult, u as AgentsSpawnResponseResult, v as AgentsUnregisterResponseResult, w as AgentsUpdateResponseResult, x as ProtocolVersion, y as SessionInfo, D as DisconnectResponseResult, z as ScopesCreateResponseResult, G as ScopesJoinResponseResult, H as ScopesLeaveResponseResult, I as ScopesListResponseResult, J as MessageId, K as SendResponseResult, L as SubscriptionId, N as SubscribeResponseResult, U as UnsubscribeResponseResult } from './index-Z76qC_Us.js';
-export { O as AGENT_ERROR_CODES, Q as AUTH_ERROR_CODES, T as AUTH_METHODS, V as AcceptanceContext, W as AgentAcceptanceRule, X as AgentConnectOptions, Y as AgentConnection, Z as AgentConnectionOptions, _ as AgentIncludeOptions, $ as AgentLifecycle, a0 as AgentMessagingRule, a1 as AgentPermissionConfig, a2 as AgentPermissions, a3 as AgentReconnectionEventHandler, a4 as AgentReconnectionEventType, a5 as AgentReconnectionOptions, a6 as AgentRelationship, a7 as AgentRelationshipType, a8 as AgentState, a9 as AgentVisibility, aa as AgentVisibilityRule, ab as AgentsGetRequest, ac as AgentsGetRequestParams, ad as AgentsListFilter, ae as AgentsListRequest, af as AgentsListRequestParams, ag as AgentsRegisterRequest, ah as AgentsRegisterRequestParams, ai as AgentsResumeRequest, aj as AgentsResumeRequestParams, ak as AgentsResumeResponseResult, al as AgentsSpawnRequest, am as AgentsSpawnRequestParams, an as AgentsStopRequest, ao as AgentsStopRequestParams, ap as AgentsStopResponseResult, aq as AgentsSuspendRequest, ar as AgentsSuspendRequestParams, as as AgentsSuspendResponseResult, at as AgentsUnregisterRequest, au as AgentsUnregisterRequestParams, av as AgentsUpdateRequest, aw as AgentsUpdateRequestParams, ax as AnyMessage, ay as AuthMethod, az as AuthParams, aA as AuthRefreshRequest, aB as AuthRefreshRequestParams, aC as AuthRefreshResponseResult, aD as BaseConnection, aE as BroadcastAddress, aF as CAPABILITY_REQUIREMENTS, aG as CORE_METHODS, aH as ClientAcceptanceRule, aI as ClientConnectOptions, aJ as ClientConnection, aK as ClientConnectionOptions, aL as ConnectRequest, aM as ConnectRequestParams, aN as CorrelationId, aO as DEFAULT_AGENT_PERMISSION_CONFIG, aP as DeliverySemantics, aQ as DirectAddress, aR as DisconnectPolicy, aS as DisconnectRequest, aT as DisconnectRequestParams, aU as ERROR_CODES, aV as EVENT_TYPES, aW as EXTENSION_METHODS, aX as EventInput, aY as EventNotification, aZ as EventNotificationParams, a_ as FEDERATION_ERROR_CODES, a$ as FEDERATION_METHODS, b0 as FederatedAddress, b1 as FederationAuth, b2 as FederationConnectRequest, b3 as FederationConnectRequestParams, b4 as FederationMetadata, b5 as FederationReplayConfig, b6 as FederationRouteRequest, b7 as FederationRouteRequestParams, b8 as GatewayReconnectionEvent, b9 as GatewayReconnectionEventHandler, ba as GatewayReconnectionEventType, bb as GatewayReconnectionOptions, bc as GraphEdge, bd as HierarchicalAddress, be as InjectDelivery, bf as InjectDeliveryResult, bg as InjectRequest, bh as InjectRequestParams, bi as InjectResponseResult, bj as JSONRPC_VERSION, bk as JoinPolicy, bl as LIFECYCLE_METHODS, bm as MAPNotification, bn as MAPNotificationBase, bo as MAPRequest, bp as MAPRequestBase, bq as MAPResponse, br as MAPResponseError, bs as MAPResponseSuccess, bt as MAP_METHODS, bu as MessageDeliveredEventData, bv as MessageFailedEventData, bw as MessageHandler, bx as MessageMeta, by as MessageNotification, bz as MessageNotificationParams, bA as MessagePriority, bB as MessageRelationship, bC as MessageSentEventData, bD as MessageVisibility, bE as Meta, bF as MultiAddress, bG as NOTIFICATION_METHODS, bH as NotificationHandler, bI as OBSERVATION_METHODS, bJ as OverflowHandler, bK as OverflowInfo, bL as PERMISSION_METHODS, bM as PROTOCOL_ERROR_CODES, bN as PROTOCOL_VERSION, bO as Participant, bP as ParticipantAddress, bQ as PermissionAction, bR as PermissionContext, bS as PermissionParticipant, bT as PermissionResult, bU as PermissionSystemConfig, bV as PermissionsAgentUpdatedEventData, bW as PermissionsClientUpdatedEventData, bX as PermissionsUpdateRequest, bY as PermissionsUpdateRequestParams, bZ as PermissionsUpdateResponseResult, b_ as RESOURCE_ERROR_CODES, b$ as ROUTING_ERROR_CODES, c0 as ReconnectionEventHandler, c1 as ReconnectionEventType, c2 as ReconnectionOptions, c3 as ReplayRequest, c4 as ReplayRequestParams, c5 as ReplayResponseResult, c6 as ReplayedEvent, c7 as RequestHandler, c8 as RoleAddress, c9 as SCOPE_METHODS, ca as SESSION_METHODS, cb as STATE_METHODS, cc as STEERING_METHODS, cd as STRUCTURE_METHODS, ce as ScopeAddress, cf as ScopeMessagingRule, cg as ScopeVisibility, ch as ScopeVisibilityRule, ci as ScopesCreateRequest, cj as ScopesCreateRequestParams, ck as ScopesDeleteRequest, cl as ScopesDeleteRequestParams, cm as ScopesDeleteResponseResult, cn as ScopesGetRequest, co as ScopesGetRequestParams, cp as ScopesGetResponseResult, cq as ScopesJoinRequest, cr as ScopesJoinRequestParams, cs as ScopesLeaveRequest, ct as ScopesLeaveRequestParams, cu as ScopesListRequest, cv as ScopesListRequestParams, cw as ScopesMembersRequest, cx as ScopesMembersRequestParams, cy as ScopesMembersResponseResult, cz as SendPolicy, cA as SendRequest, cB as SendRequestParams, cC as SessionCloseRequest, cD as SessionCloseRequestParams, cE as SessionCloseResponseResult, cF as SessionListRequest, cG as SessionListRequestParams, cH as SessionListResponseResult, cI as SessionLoadRequest, cJ as SessionLoadRequestParams, cK as SessionLoadResponseResult, cL as StateChangeHandler, cM as StreamingCapabilities, cN as StructureGraphRequest, cO as StructureGraphRequestParams, cP as StructureGraphResponseResult, cQ as StructureVisibilityRule, cR as SubscribeRequest, cS as SubscribeRequestParams, cT as Subscription, cU as SubscriptionAckNotification, cV as SubscriptionAckParams, cW as SubscriptionOptions, cX as SubscriptionState, cY as SystemAcceptanceRule, cZ as SystemAddress, c_ as Timestamp, c$ as TransportType, d0 as UnsubscribeRequest, d1 as UnsubscribeRequestParams, d2 as canAgentAcceptMessage, d3 as canAgentMessageAgent, d4 as canAgentSeeAgent, d5 as canControlAgent, d6 as canJoinScope, d7 as canMessageAgent, d8 as canPerformAction, d9 as canPerformMethod, da as canSeeAgent, db as canSeeScope, dc as canSendToScope, dd as createEvent, de as createStreamPair, df as createSubscription, dg as deepMergePermissions, dh as filterVisibleAgents, di as filterVisibleEvents, dj as filterVisibleScopes, dk as hasCapability, dl as isAgentExposed, dm as isBroadcastAddress, dn as isDirectAddress, dp as isEventTypeExposed, dq as isFederatedAddress, dr as isHierarchicalAddress, ds as isOrphanedAgent, dt as isScopeExposed, du as isSuccessResponse, dv as mapVisibilityToRule, dw as ndJsonStream, dx as resolveAgentPermissions, dy as waitForOpen, dz as websocketStream } from './index-Z76qC_Us.js';
+import { R as RequestId, M as MAPError, a as MAPErrorData, E as ErrorCategory, F as FederationBufferConfig, b as FederationEnvelope, c as Message, S as Stream, B as BaseConnectionOptions, P as ParticipantCapabilities, d as FederationRoutingConfig, e as EventType, C as ConnectResponseResult, f as SessionId, g as FederationConnectResponseResult, h as FederationRouteResponseResult, i as ConnectionState, j as ParticipantId, k as ParticipantType, A as AgentId, l as ScopeId, m as Agent, n as Scope, o as Address, p as SubscriptionFilter, q as Event, r as AgentsGetResponseResult, s as AgentsListResponseResult, t as AgentsRegisterResponseResult, u as AgentsSpawnResponseResult, v as AgentsUnregisterResponseResult, w as AgentsUpdateResponseResult, x as ProtocolVersion, y as SessionInfo, D as DisconnectResponseResult, z as ScopesCreateResponseResult, G as ScopesJoinResponseResult, H as ScopesLeaveResponseResult, I as ScopesListResponseResult, J as MessageId, K as SendResponseResult, L as SubscriptionId, N as SubscribeResponseResult, U as UnsubscribeResponseResult, O as AgentVisibility, Q as ScopeVisibility, T as AgentState, V as MessageMeta, W as AgentConnection, X as ACPAgentHandler, Y as ACPSessionNotification, Z as ACPRequestPermissionRequest, _ as ACPRequestPermissionResponse, $ as ACPReadTextFileRequest, a0 as ACPReadTextFileResponse, a1 as ACPWriteTextFileRequest, a2 as ACPWriteTextFileResponse, a3 as ACPCreateTerminalRequest, a4 as ACPCreateTerminalResponse, a5 as ACPTerminalOutputRequest, a6 as ACPTerminalOutputResponse, a7 as ACPReleaseTerminalRequest, a8 as ACPReleaseTerminalResponse, a9 as ACPWaitForTerminalExitRequest, aa as ACPWaitForTerminalExitResponse, ab as ACPKillTerminalCommandRequest, ac as ACPKillTerminalCommandResponse, ad as ACPSessionId } from './index-BQXp4_rd.js';
+export { ae as ACPAgentCapabilities, af as ACPAgentContext, ag as ACPAnnotations, ah as ACPAudioContent, ai as ACPAuthMethod, aj as ACPAuthenticateRequest, ak as ACPAuthenticateResponse, al as ACPAvailableCommand, am as ACPAvailableCommandsUpdate, an as ACPBlobResourceContents, ao as ACPCancelNotification, ap as ACPCancelledPermissionOutcome, aq as ACPCapability, ar as ACPClientCapabilities, as as ACPClientHandlers, at as ACPContent, au as ACPContentBlock, av as ACPContentChunk, aw as ACPContext, ax as ACPCurrentModeUpdate, ay as ACPDiff, az as ACPEmbeddedResource, aA as ACPEnvVariable, aB as ACPEnvelope, aC as ACPError, aD as ACPErrorCode, aE as ACPErrorObject, aF as ACPErrorResponse, aG as ACPFileSystemCapability, aH as ACPHttpHeader, aI as ACPImageContent, aJ as ACPImplementation, aK as ACPInitializeRequest, aL as ACPInitializeResponse, aM as ACPLoadSessionRequest, aN as ACPLoadSessionResponse, aO as ACPMcpCapabilities, aP as ACPMcpServer, aQ as ACPMcpServerHttp, aR as ACPMcpServerSse, aS as ACPMcpServerStdio, aT as ACPMessage, aU as ACPMeta, aV as ACPNewSessionRequest, aW as ACPNewSessionResponse, aX as ACPNotification, aY as ACPPermissionOption, aZ as ACPPermissionOptionId, a_ as ACPPermissionOptionKind, a$ as ACPPlan, b0 as ACPPlanEntry, b1 as ACPPlanEntryPriority, b2 as ACPPlanEntryStatus, b3 as ACPPromptCapabilities, b4 as ACPPromptRequest, b5 as ACPPromptResponse, b6 as ACPProtocolVersion, b7 as ACPRequest, b8 as ACPRequestId, b9 as ACPRequestPermissionOutcome, ba as ACPResourceLink, bb as ACPResponse, bc as ACPRole, bd as ACPSelectedPermissionOutcome, be as ACPSessionCapabilities, bf as ACPSessionInfoUpdate, bg as ACPSessionMode, bh as ACPSessionModeId, bi as ACPSessionModeState, bj as ACPSessionUpdate, bk as ACPSetSessionModeRequest, bl as ACPSetSessionModeResponse, bm as ACPStopReason, bn as ACPStreamConnection, bo as ACPStreamEvents, bp as ACPStreamOptions, bq as ACPSuccessResponse, br as ACPTerminal, bs as ACPTerminalExitStatus, bt as ACPTextContent, bu as ACPTextResourceContents, bv as ACPToolCall, bw as ACPToolCallContent, bx as ACPToolCallId, by as ACPToolCallLocation, bz as ACPToolCallStatus, bA as ACPToolCallUpdate, bB as ACPToolKind, bC as ACP_ERROR_CODES, bD as ACP_METHODS, bE as ACP_PROTOCOL_VERSION, bF as AGENT_ERROR_CODES, bG as AUTH_ERROR_CODES, bH as AUTH_METHODS, bI as AcceptanceContext, bJ as AgentAcceptanceRule, bK as AgentConnectOptions, bL as AgentConnectionOptions, bM as AgentIncludeOptions, bN as AgentLifecycle, bO as AgentMeshConnectOptions, bP as AgentMessagingRule, bQ as AgentPermissionConfig, bR as AgentPermissions, bS as AgentReconnectionEventHandler, bT as AgentReconnectionEventType, bU as AgentReconnectionOptions, bV as AgentRelationship, bW as AgentRelationshipType, bX as AgentVisibilityRule, bY as AgenticMeshStreamConfig, bZ as AgentsGetRequest, b_ as AgentsGetRequestParams, b$ as AgentsListFilter, c0 as AgentsListRequest, c1 as AgentsListRequestParams, c2 as AgentsRegisterRequest, c3 as AgentsRegisterRequestParams, c4 as AgentsResumeRequest, c5 as AgentsResumeRequestParams, c6 as AgentsResumeResponseResult, c7 as AgentsSpawnRequest, c8 as AgentsSpawnRequestParams, c9 as AgentsStopRequest, ca as AgentsStopRequestParams, cb as AgentsStopResponseResult, cc as AgentsSuspendRequest, cd as AgentsSuspendRequestParams, ce as AgentsSuspendResponseResult, cf as AgentsUnregisterRequest, cg as AgentsUnregisterRequestParams, ch as AgentsUpdateRequest, ci as AgentsUpdateRequestParams, cj as AnyMessage, ck as AuthCredentials, cl as AuthError, cm as AuthErrorCode, cn as AuthMethod, co as AuthPrincipal, cp as AuthRefreshRequest, cq as AuthRefreshRequestParams, cr as AuthRefreshResponseResult, cs as AuthResult, ct as AuthenticateRequest, cu as AuthenticateRequestParams, cv as AuthenticateResponseResult, cw as BaseConnection, cx as BroadcastAddress, cy as CAPABILITY_REQUIREMENTS, cz as CORE_METHODS, cA as ClientAcceptanceRule, cB as ClientConnectOptions, cC as ClientConnection, cD as ClientConnectionOptions, cE as ConnectRequest, cF as ConnectRequestParams, cG as CorrelationId, cH as DEFAULT_AGENT_PERMISSION_CONFIG, cI as DeliverySemantics, cJ as DirectAddress, cK as DisconnectPolicy, cL as DisconnectRequest, cM as DisconnectRequestParams, cN as ERROR_CODES, cO as EVENT_TYPES, cP as EXTENSION_METHODS, cQ as EventInput, cR as EventNotification, cS as EventNotificationParams, cT as FEDERATION_ERROR_CODES, cU as FEDERATION_METHODS, cV as FederatedAddress, cW as FederationAuth, cX as FederationConnectRequest, cY as FederationConnectRequestParams, cZ as FederationMetadata, c_ as FederationReplayConfig, c$ as FederationRouteRequest, d0 as FederationRouteRequestParams, d1 as GatewayReconnectionEvent, d2 as GatewayReconnectionEventHandler, d3 as GatewayReconnectionEventType, d4 as GatewayReconnectionOptions, d5 as GraphEdge, d6 as HierarchicalAddress, d7 as InjectDelivery, d8 as InjectDeliveryResult, d9 as InjectRequest, da as InjectRequestParams, db as InjectResponseResult, dc as JSONRPC_VERSION, dd as JoinPolicy, de as LIFECYCLE_METHODS, df as MAPNotification, dg as MAPNotificationBase, dh as MAPRequest, di as MAPRequestBase, dj as MAPResponse, dk as MAPResponseError, dl as MAPResponseSuccess, dm as MAP_METHODS, dn as MeshConnectOptions, dp as MeshPeerEndpoint, dq as MeshTransportAdapter, dr as MessageDeliveredEventData, ds as MessageFailedEventData, dt as MessageHandler, du as MessageNotification, dv as MessageNotificationParams, dw as MessagePriority, dx as MessageRelationship, dy as MessageSentEventData, dz as MessageVisibility, dA as Meta, dB as MultiAddress, dC as NOTIFICATION_METHODS, dD as NotificationHandler, dE as OBSERVATION_METHODS, dF as OverflowHandler, dG as OverflowInfo, dH as PERMISSION_METHODS, dI as PROTOCOL_ERROR_CODES, dJ as PROTOCOL_VERSION, dK as Participant, dL as ParticipantAddress, dM as PermissionAction, dN as PermissionContext, dO as PermissionParticipant, dP as PermissionResult, dQ as PermissionSystemConfig, dR as PermissionsAgentUpdatedEventData, dS as PermissionsClientUpdatedEventData, dT as PermissionsUpdateRequest, dU as PermissionsUpdateRequestParams, dV as PermissionsUpdateResponseResult, dW as RESOURCE_ERROR_CODES, dX as ROUTING_ERROR_CODES, dY as ReconnectionEventHandler, dZ as ReconnectionEventType, d_ as ReconnectionOptions, d$ as ReplayRequest, e0 as ReplayRequestParams, e1 as ReplayResponseResult, e2 as ReplayedEvent, e3 as RequestHandler, e4 as RoleAddress, e5 as SCOPE_METHODS, e6 as SESSION_METHODS, e7 as STATE_METHODS, e8 as STEERING_METHODS, e9 as STRUCTURE_METHODS, ea as ScopeAddress, eb as ScopeMessagingRule, ec as ScopeVisibilityRule, ed as ScopesCreateRequest, ee as ScopesCreateRequestParams, ef as ScopesDeleteRequest, eg as ScopesDeleteRequestParams, eh as ScopesDeleteResponseResult, ei as ScopesGetRequest, ej as ScopesGetRequestParams, ek as ScopesGetResponseResult, el as ScopesJoinRequest, em as ScopesJoinRequestParams, en as ScopesLeaveRequest, eo as ScopesLeaveRequestParams, ep as ScopesListRequest, eq as ScopesListRequestParams, er as ScopesMembersRequest, es as ScopesMembersRequestParams, et as ScopesMembersResponseResult, eu as SendPolicy, ev as SendRequest, ew as SendRequestParams, ex as ServerAuthCapabilities, ey as SessionCloseRequest, ez as SessionCloseRequestParams, eA as SessionCloseResponseResult, eB as SessionListRequest, eC as SessionListRequestParams, eD as SessionListResponseResult, eE as SessionLoadRequest, eF as SessionLoadRequestParams, eG as SessionLoadResponseResult, eH as StandardAuthMethod, eI as StateChangeHandler, eJ as StreamingCapabilities, eK as StructureGraphRequest, eL as StructureGraphRequestParams, eM as StructureGraphResponseResult, eN as StructureVisibilityRule, eO as SubscribeRequest, eP as SubscribeRequestParams, eQ as Subscription, eR as SubscriptionAckNotification, eS as SubscriptionAckParams, eT as SubscriptionOptions, eU as SubscriptionState, eV as SystemAcceptanceRule, eW as SystemAddress, eX as Timestamp, eY as TransportType, eZ as UnsubscribeRequest, e_ as UnsubscribeRequestParams, e$ as agenticMeshStream, f0 as canAgentAcceptMessage, f1 as canAgentMessageAgent, f2 as canAgentSeeAgent, f3 as canControlAgent, f4 as canJoinScope, f5 as canMessageAgent, f6 as canPerformAction, f7 as canPerformMethod, f8 as canSeeAgent, f9 as canSeeScope, fa as canSendToScope, fb as createACPStream, fc as createEvent, fd as createStreamPair, fe as createSubscription, ff as deepMergePermissions, fg as filterVisibleAgents, fh as filterVisibleEvents, fi as filterVisibleScopes, fj as hasCapability, fk as isACPEnvelope, fl as isACPErrorResponse, fm as isACPNotification, fn as isACPRequest, fo as isACPResponse, fp as isACPSuccessResponse, fq as isAgentExposed, fr as isBroadcastAddress, fs as isDirectAddress, ft as isEventTypeExposed, fu as isFederatedAddress, fv as isHierarchicalAddress, fw as isOrphanedAgent, fx as isScopeExposed, fy as isSuccessResponse, fz as mapVisibilityToRule, fA as ndJsonStream, fB as resolveAgentPermissions, fC as waitForOpen, fD as websocketStream } from './index-BQXp4_rd.js';
 import { z } from 'zod';
 export { monotonicFactory, ulid } from 'ulid';
+import 'events';
 
 /**
  * JSON-RPC 2.0 utilities for MAP protocol
@@ -108,6 +109,9 @@ declare class MAPRequestError extends Error {
     static authFailed(details?: string): MAPRequestError;
     static tokenExpired(): MAPRequestError;
     static permissionDenied(required?: string): MAPRequestError;
+    static insufficientScope(required?: string): MAPRequestError;
+    static methodNotSupported(method: string): MAPRequestError;
+    static invalidCredentials(details?: string): MAPRequestError;
     static addressNotFound(address: string): MAPRequestError;
     static agentNotFound(agentId: string): MAPRequestError;
     static scopeNotFound(scopeId: string): MAPRequestError;
@@ -1117,6 +1121,7 @@ declare const AgentSchema: z.ZodObject<{
     state: string;
     role?: string | undefined;
     parent?: string | undefined;
+    _meta?: Record<string, unknown> | undefined;
     name?: string | undefined;
     capabilities?: {
         _meta?: Record<string, unknown> | undefined;
@@ -1141,7 +1146,6 @@ declare const AgentSchema: z.ZodObject<{
             canStop?: boolean | undefined;
         } | undefined;
     } | undefined;
-    _meta?: Record<string, unknown> | undefined;
     visibility?: "system" | "public" | "parent-only" | "scope" | undefined;
     scopes?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
@@ -1166,6 +1170,7 @@ declare const AgentSchema: z.ZodObject<{
     state: string;
     role?: string | undefined;
     parent?: string | undefined;
+    _meta?: Record<string, unknown> | undefined;
     name?: string | undefined;
     capabilities?: {
         _meta?: Record<string, unknown> | undefined;
@@ -1190,7 +1195,6 @@ declare const AgentSchema: z.ZodObject<{
             canStop?: boolean | undefined;
         } | undefined;
     } | undefined;
-    _meta?: Record<string, unknown> | undefined;
     visibility?: "system" | "public" | "parent-only" | "scope" | undefined;
     scopes?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
@@ -1226,8 +1230,8 @@ declare const ScopeSchema: z.ZodObject<{
     id: string;
     parent?: string | undefined;
     children?: string[] | undefined;
-    name?: string | undefined;
     _meta?: Record<string, unknown> | undefined;
+    name?: string | undefined;
     visibility?: "public" | "private" | "unlisted" | undefined;
     metadata?: Record<string, unknown> | undefined;
     joinPolicy?: "open" | "invite" | "approval" | undefined;
@@ -1237,8 +1241,8 @@ declare const ScopeSchema: z.ZodObject<{
     id: string;
     parent?: string | undefined;
     children?: string[] | undefined;
-    name?: string | undefined;
     _meta?: Record<string, unknown> | undefined;
+    name?: string | undefined;
     visibility?: "public" | "private" | "unlisted" | undefined;
     metadata?: Record<string, unknown> | undefined;
     joinPolicy?: "open" | "invite" | "approval" | undefined;
@@ -1257,8 +1261,9 @@ declare const MessageMetaSchema: z.ZodObject<{
     isResult: z.ZodOptional<z.ZodBoolean>;
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
-    _meta?: Record<string, unknown> | undefined;
     correlationId?: string | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    expiresAt?: number | undefined;
     relationship?: "peer" | "parent-to-child" | "child-to-parent" | "broadcast" | "supervisor-to-supervised" | undefined;
     isResult?: boolean | undefined;
     causationId?: string | undefined;
@@ -1266,10 +1271,10 @@ declare const MessageMetaSchema: z.ZodObject<{
     spanId?: string | undefined;
     priority?: "urgent" | "high" | "normal" | "low" | undefined;
     delivery?: "at-most-once" | "at-least-once" | "exactly-once" | undefined;
-    expiresAt?: number | undefined;
 }, {
-    _meta?: Record<string, unknown> | undefined;
     correlationId?: string | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    expiresAt?: number | undefined;
     relationship?: "peer" | "parent-to-child" | "child-to-parent" | "broadcast" | "supervisor-to-supervised" | undefined;
     isResult?: boolean | undefined;
     causationId?: string | undefined;
@@ -1277,7 +1282,6 @@ declare const MessageMetaSchema: z.ZodObject<{
     spanId?: string | undefined;
     priority?: "urgent" | "high" | "normal" | "low" | undefined;
     delivery?: "at-most-once" | "at-least-once" | "exactly-once" | undefined;
-    expiresAt?: number | undefined;
 }>;
 declare const MessageSchema: z.ZodObject<{
     id: z.ZodString;
@@ -1297,8 +1301,9 @@ declare const MessageSchema: z.ZodObject<{
         isResult: z.ZodOptional<z.ZodBoolean>;
         _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strict", z.ZodTypeAny, {
-        _meta?: Record<string, unknown> | undefined;
         correlationId?: string | undefined;
+        _meta?: Record<string, unknown> | undefined;
+        expiresAt?: number | undefined;
         relationship?: "peer" | "parent-to-child" | "child-to-parent" | "broadcast" | "supervisor-to-supervised" | undefined;
         isResult?: boolean | undefined;
         causationId?: string | undefined;
@@ -1306,10 +1311,10 @@ declare const MessageSchema: z.ZodObject<{
         spanId?: string | undefined;
         priority?: "urgent" | "high" | "normal" | "low" | undefined;
         delivery?: "at-most-once" | "at-least-once" | "exactly-once" | undefined;
-        expiresAt?: number | undefined;
     }, {
-        _meta?: Record<string, unknown> | undefined;
         correlationId?: string | undefined;
+        _meta?: Record<string, unknown> | undefined;
+        expiresAt?: number | undefined;
         relationship?: "peer" | "parent-to-child" | "child-to-parent" | "broadcast" | "supervisor-to-supervised" | undefined;
         isResult?: boolean | undefined;
         causationId?: string | undefined;
@@ -1317,17 +1322,18 @@ declare const MessageSchema: z.ZodObject<{
         spanId?: string | undefined;
         priority?: "urgent" | "high" | "normal" | "low" | undefined;
         delivery?: "at-most-once" | "at-least-once" | "exactly-once" | undefined;
-        expiresAt?: number | undefined;
     }>>;
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
     id: string;
     timestamp: number;
     from: string;
+    payload?: unknown;
     _meta?: Record<string, unknown> | undefined;
     meta?: {
-        _meta?: Record<string, unknown> | undefined;
         correlationId?: string | undefined;
+        _meta?: Record<string, unknown> | undefined;
+        expiresAt?: number | undefined;
         relationship?: "peer" | "parent-to-child" | "child-to-parent" | "broadcast" | "supervisor-to-supervised" | undefined;
         isResult?: boolean | undefined;
         causationId?: string | undefined;
@@ -1335,18 +1341,18 @@ declare const MessageSchema: z.ZodObject<{
         spanId?: string | undefined;
         priority?: "urgent" | "high" | "normal" | "low" | undefined;
         delivery?: "at-most-once" | "at-least-once" | "exactly-once" | undefined;
-        expiresAt?: number | undefined;
     } | undefined;
-    payload?: unknown;
     to?: unknown;
 }, {
     id: string;
     timestamp: number;
     from: string;
+    payload?: unknown;
     _meta?: Record<string, unknown> | undefined;
     meta?: {
-        _meta?: Record<string, unknown> | undefined;
         correlationId?: string | undefined;
+        _meta?: Record<string, unknown> | undefined;
+        expiresAt?: number | undefined;
         relationship?: "peer" | "parent-to-child" | "child-to-parent" | "broadcast" | "supervisor-to-supervised" | undefined;
         isResult?: boolean | undefined;
         causationId?: string | undefined;
@@ -1354,9 +1360,7 @@ declare const MessageSchema: z.ZodObject<{
         spanId?: string | undefined;
         priority?: "urgent" | "high" | "normal" | "low" | undefined;
         delivery?: "at-most-once" | "at-least-once" | "exactly-once" | undefined;
-        expiresAt?: number | undefined;
     } | undefined;
-    payload?: unknown;
     to?: unknown;
 }>;
 declare const EventSchema: z.ZodObject<{
@@ -1378,20 +1382,20 @@ declare const EventSchema: z.ZodObject<{
 declare const SubscriptionFilterSchema: z.ZodObject<{
     eventTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["agent.registered", "agent.unregistered", "agent.state-changed", "agent.spawned", "scope.created", "scope.deleted", "scope.joined", "scope.left", "message.sent", "message.delivered", "session.started", "session.ended", "system.error", "system.shutdown"]>, "many">>;
     scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    agents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    fromAgents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     includeChildren: z.ZodOptional<z.ZodBoolean>;
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
-    agents?: string[] | undefined;
     _meta?: Record<string, unknown> | undefined;
     scopes?: string[] | undefined;
     eventTypes?: ("agent.registered" | "agent.unregistered" | "agent.state-changed" | "agent.spawned" | "scope.created" | "scope.deleted" | "scope.joined" | "scope.left" | "message.sent" | "message.delivered" | "session.started" | "session.ended" | "system.error" | "system.shutdown")[] | undefined;
+    fromAgents?: string[] | undefined;
     includeChildren?: boolean | undefined;
 }, {
-    agents?: string[] | undefined;
     _meta?: Record<string, unknown> | undefined;
     scopes?: string[] | undefined;
     eventTypes?: ("agent.registered" | "agent.unregistered" | "agent.state-changed" | "agent.spawned" | "scope.created" | "scope.deleted" | "scope.joined" | "scope.left" | "message.sent" | "message.delivered" | "session.started" | "session.ended" | "system.error" | "system.shutdown")[] | undefined;
+    fromAgents?: string[] | undefined;
     includeChildren?: boolean | undefined;
 }>;
 declare const MAPErrorDataSchema: z.ZodObject<{
@@ -2407,4 +2411,617 @@ declare function toAgent(agentId: string): string;
  */
 declare function toScope(scopeId: string): string;
 
-export { Address, type AddressComponents, AddressSchema, type AddressType, type AddressValidated, Agent, type AgentExposure, AgentId, AgentIdSchema, type AgentIdValidated, AgentLifecycleSchema, AgentRelationshipSchema, AgentSchema, AgentStateSchema, type AgentStateValidated, type AgentValidated, AgentVisibilitySchema, AgentsGetResponseResult, AgentsListResponseResult, AgentsRegisterResponseResult, AgentsSpawnResponseResult, AgentsUnregisterResponseResult, AgentsUpdateResponseResult, BaseConnectionOptions, BroadcastAddressSchema, type CapabilityPath, type CausalBufferPushResult, type CausalEvent, CausalEventBuffer, type CausalEventBufferOptions, ConnectResponseResult, type ConnectedParticipant, ConnectionState, CorrelationIdSchema, type CreateEnvelopeOptions, DEFAULT_RETRY_POLICY, DeliverySemanticsSchema, DirectAddressSchema, DisconnectResponseResult, ErrorCategory, ErrorCategorySchema, Event, type EventExposure, EventSchema, EventType, EventTypeSchema, type EventValidated, FederatedAddressSchema, FederationBufferConfig, FederationConnectResponseResult, FederationEnvelope, FederationOutageBuffer, FederationRouteResponseResult, FederationRoutingConfig, GatewayConnection, type GatewayConnectionOptions, HierarchicalAddressSchema, InvalidAddressError, JsonRpcVersionSchema, MAPConnectionError, MAPError, MAPErrorData, MAPErrorDataSchema, MAPErrorSchema, type MAPErrorValidated, MAPNotificationSchema, type MAPNotificationValidated, MAPRequestError, MAPRequestSchema, type MAPRequestValidated, MAPResponseErrorSchema, MAPResponseSchema, MAPResponseSuccessSchema, type MAPResponseValidated, type MAPRouter, type MAPRouterConfig, type MAPRouterFactory, MAPTimeoutError, METHOD_REGISTRY, Message, MessageId, MessageIdSchema, type MessageIdValidated, MessageMetaSchema, MessagePrioritySchema, MessageRelationshipSchema, MessageSchema, type MessageValidated, MessageVisibilitySchema, MetaSchema, type MethodCategory, type MethodInfo, MultiAddressSchema, ParticipantAddressSchema, ParticipantCapabilities, ParticipantCapabilitiesSchema, type ParticipantCapabilitiesValidated, ParticipantId, ParticipantIdSchema, type ParticipantIdValidated, ParticipantType, ParticipantTypeSchema, type ParticipantTypeValidated, type PeerBufferStats, type ProcessEnvelopeResult, ProtocolVersion, ProtocolVersionSchema, RequestId, RequestIdSchema, type RetryCallbacks, type RetryPolicy, type RetryState, RoleAddressSchema, type RouterLimits, Scope, ScopeAddressSchema, type ScopeExposure, ScopeId, ScopeIdSchema, type ScopeIdValidated, ScopeJoinPolicySchema, ScopeSchema, ScopeSendPolicySchema, type ScopeValidated, ScopeVisibilitySchema, ScopesCreateResponseResult, ScopesJoinResponseResult, ScopesLeaveResponseResult, ScopesListResponseResult, SendResponseResult, SessionId, SessionIdSchema, type SessionIdValidated, SessionInfo, Stream, SubscribeResponseResult, SubscriptionFilter, SubscriptionFilterSchema, type SubscriptionFilterValidated, SubscriptionId, SubscriptionIdSchema, SystemAddressSchema, type SystemExposure, TimestampSchema, TransportTypeSchema, UnsubscribeResponseResult, buildAgentsGetResponse, buildAgentsListResponse, buildAgentsRegisterResponse, buildAgentsSpawnResponse, buildAgentsUnregisterResponse, buildAgentsUpdateResponse, buildConnectResponse, buildDisconnectResponse, buildScopesCreateResponse, buildScopesJoinResponse, buildScopesLeaveResponse, buildScopesListResponse, buildSendResponse, buildSubscribeResponse, buildUnsubscribeResponse, calculateDelay, compareUlid, createErrorResponse, createFederationEnvelope, createNotification, createRequest, createRetryPolicy, createSuccessResponse, extractId, extractType, formatAddress, getEnvelopeRoutingInfo, getMethodInfo, getMethodsByCategory, getRequiredCapabilities, hasRequiredCapabilities, isAddress, isAgentAddress, isEnvelopeAtDestination, isErrorResponse, isNotification, isRequest, isResponse, isScopeAddress, isValidEnvelope, isValidUlid, parseAddress, processFederationEnvelope, retryable, sleep, sortCausalOrder, toAgent, toScope, ulidTimestamp, unwrapEnvelope, validateCausalOrder, withPayload, withRetry };
+/**
+ * Type definitions for MAPMeshPeer
+ *
+ * These types define the configuration and interfaces for decentralized
+ * P2P mesh peers that run their own MAP server.
+ */
+
+/**
+ * Peer endpoint for mesh connections.
+ */
+interface PeerEndpoint {
+    /** Unique peer identifier */
+    peerId: string;
+    /** Transport-specific address (IP, hostname, etc.) */
+    address: string;
+    /** Optional port number */
+    port?: number;
+    /** Additional transport-specific metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Transport adapter interface (subset used by MAPMeshPeer).
+ * Full interface is defined in agentic-mesh.
+ */
+interface TransportAdapter {
+    /** Whether the transport is currently active */
+    readonly active: boolean;
+    /** Start the transport */
+    start(): Promise<void>;
+    /** Stop the transport */
+    stop(): Promise<void>;
+    /** Connect to a peer endpoint */
+    connect(endpoint: PeerEndpoint): Promise<boolean>;
+    /** Check if connected to a peer */
+    isConnected(peerId: string): boolean;
+    /** Event emitter methods */
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+}
+/**
+ * Git sync configuration for MAPMeshPeer.
+ */
+interface MeshGitConfig {
+    /** Enable git sync service */
+    enabled: boolean;
+    /** Local repository path */
+    repoPath: string;
+    /** HTTP port for git-remote-mesh helper (default: 3456) */
+    httpPort?: number;
+    /** HTTP host to bind (default: 127.0.0.1) */
+    httpHost?: string;
+    /** Additional git transport options */
+    options?: Record<string, unknown>;
+}
+/**
+ * MAP server configuration options.
+ */
+interface MeshMapServerConfig {
+    /** System name for the MAP server */
+    systemName?: string;
+    /** Additional server options */
+    [key: string]: unknown;
+}
+/**
+ * Configuration for creating a MAPMeshPeer.
+ */
+interface MAPMeshPeerConfig {
+    /** Unique peer identifier */
+    peerId: string;
+    /** Display name for this peer */
+    peerName?: string;
+    /** Transport adapter (from agentic-mesh) */
+    transport: TransportAdapter;
+    /** Git sync configuration (optional) */
+    git?: MeshGitConfig;
+    /** Initial peers to connect to on start */
+    peers?: PeerEndpoint[];
+    /** MAP server configuration */
+    map?: MeshMapServerConfig;
+}
+/**
+ * Configuration for creating a local agent.
+ */
+interface CreateAgentConfig {
+    /** Agent ID (auto-generated if not provided) */
+    agentId?: AgentId;
+    /** Agent name */
+    name?: string;
+    /** Agent role */
+    role?: string;
+    /** Initial scopes to join */
+    scopes?: ScopeId[];
+    /** Agent visibility settings */
+    visibility?: AgentVisibility;
+    /** Initial metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a send operation.
+ */
+interface SendResult {
+    /** IDs of participants who received the message */
+    delivered: string[];
+    /** Failed deliveries with reasons */
+    failed?: Array<{
+        participantId: string;
+        reason: string;
+    }>;
+}
+/**
+ * Local agent on this peer's MapServer.
+ */
+interface LocalAgent {
+    /** Agent ID */
+    readonly agentId: AgentId;
+    /** Agent name */
+    readonly name: string;
+    /** Agent role */
+    readonly role?: string;
+    /** Current agent state */
+    readonly state: AgentState;
+    /** Mark agent as busy */
+    busy(): Promise<void>;
+    /** Mark agent as idle */
+    idle(): Promise<void>;
+    /** Update agent state */
+    updateState(state: AgentState): Promise<void>;
+    /** Update agent metadata */
+    updateMetadata(metadata: Record<string, unknown>): Promise<void>;
+    /** Send a message */
+    send(to: Address, payload: unknown, meta?: MessageMeta): Promise<SendResult>;
+    /** Register message handler */
+    onMessage(handler: (message: Message) => void | Promise<void>): () => void;
+    /** Unregister this agent */
+    unregister(reason?: string): Promise<void>;
+}
+/**
+ * Configuration for creating a scope.
+ */
+interface CreateScopeConfig {
+    /** Scope ID (auto-generated if not provided) */
+    scopeId?: ScopeId;
+    /** Scope name */
+    name?: string;
+    /** Scope description */
+    description?: string;
+    /** Scope visibility */
+    visibility?: ScopeVisibility;
+    /** Scope metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for sync operations.
+ */
+interface SyncOptions {
+    /** Branch to sync (default: current branch) */
+    branch?: string;
+    /** Remote name to use */
+    remoteName?: string;
+    /** Bidirectional sync (pull then push) */
+    bidirectional?: boolean;
+    /** Force sync (overwrite conflicts) */
+    force?: boolean;
+    /** Use rebase instead of merge */
+    rebase?: boolean;
+}
+/**
+ * Options for pull operations.
+ */
+interface PullOptions {
+    /** Use rebase instead of merge */
+    rebase?: boolean;
+    /** Fast-forward only (fail if not possible) */
+    ffOnly?: boolean;
+}
+/**
+ * Options for push operations.
+ */
+interface PushOptions {
+    /** Force push */
+    force?: boolean;
+    /** Set upstream tracking */
+    setUpstream?: boolean;
+    /** Push all branches */
+    all?: boolean;
+    /** Push tags */
+    tags?: boolean;
+}
+/**
+ * Options for clone operations.
+ */
+interface CloneOptions {
+    /** Branch to clone */
+    branch?: string;
+    /** Shallow clone depth */
+    depth?: number;
+    /** Clone as bare repository */
+    bare?: boolean;
+}
+/**
+ * Result of a git sync operation.
+ */
+interface SyncResult {
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Type of operation performed */
+    operation: 'fetch' | 'pull' | 'push' | 'clone' | 'sync';
+    /** Peer ID involved */
+    peerId: string;
+    /** Branch involved */
+    branch?: string;
+    /** Commits transferred */
+    commits?: string[];
+    /** Error message if failed */
+    error?: string;
+    /** Command output */
+    output?: string;
+}
+/**
+ * Git sync client for a specific repository.
+ */
+interface GitSyncClient {
+    /** Bidirectional sync with a peer */
+    sync(peerId: string, options?: SyncOptions): Promise<SyncResult>;
+    /** Fetch from a peer */
+    fetch(peerId: string, branch?: string): Promise<SyncResult>;
+    /** Pull from a peer */
+    pull(peerId: string, branch?: string, options?: PullOptions): Promise<SyncResult>;
+    /** Push to a peer */
+    push(peerId: string, branch?: string, options?: PushOptions): Promise<SyncResult>;
+    /** Clone from a peer */
+    clone(peerId: string, destPath: string, options?: CloneOptions): Promise<SyncResult>;
+    /** List refs on remote peer */
+    listRemoteRefs(peerId: string): Promise<Array<{
+        ref: string;
+        sha: string;
+    }>>;
+}
+/**
+ * Git sync service exposed by MAPMeshPeer.
+ */
+interface GitSyncService {
+    /** Whether the git service is running */
+    readonly isRunning: boolean;
+    /** HTTP port for git-remote-mesh helper */
+    readonly httpPort: number;
+    /** Create a sync client for a specific repository */
+    createSyncClient(repoPath: string): GitSyncClient;
+    /** Sync with a peer */
+    sync(peerId: string, options?: SyncOptions): Promise<SyncResult>;
+    /** Pull from a peer */
+    pull(peerId: string, branch?: string, options?: PullOptions): Promise<SyncResult>;
+    /** Push to a peer */
+    push(peerId: string, branch?: string, options?: PushOptions): Promise<SyncResult>;
+    /** Clone from a peer */
+    clone(peerId: string, destPath: string, options?: CloneOptions): Promise<SyncResult>;
+}
+/**
+ * Event subscription for MAPMeshPeer.
+ */
+interface MeshEventSubscription {
+    /** Subscription ID */
+    readonly id: SubscriptionId;
+    /** Async iterator for events */
+    [Symbol.asyncIterator](): AsyncIterator<Event>;
+    /** Unsubscribe */
+    unsubscribe(): Promise<void>;
+}
+/**
+ * Events emitted by MAPMeshPeer.
+ */
+interface MAPMeshPeerEvents {
+    /** Peer started */
+    started: () => void;
+    /** Peer stopped */
+    stopped: () => void;
+    /** Connected to a peer */
+    'peer:connected': (peerId: string, endpoint: PeerEndpoint) => void;
+    /** Disconnected from a peer */
+    'peer:disconnected': (peerId: string, reason?: string) => void;
+    /** Agent registered on this peer */
+    'agent:registered': (agent: Agent) => void;
+    /** Agent unregistered from this peer */
+    'agent:unregistered': (agent: Agent) => void;
+    /** Scope created */
+    'scope:created': (scope: Scope) => void;
+    /** Scope deleted */
+    'scope:deleted': (scope: Scope) => void;
+    /** Error occurred */
+    error: (error: Error) => void;
+}
+
+/**
+ * MAPMeshPeer - Decentralized P2P mesh peer
+ *
+ * Wraps agentic-mesh's MeshPeer to provide a unified interface for
+ * decentralized MAP networks where each peer runs its own MapServer.
+ *
+ * @module
+ */
+
+/**
+ * Decentralized P2P mesh peer with MAP protocol support.
+ *
+ * Each MAPMeshPeer runs its own MapServer and can connect to other peers
+ * for agent discovery, messaging, and git synchronization.
+ *
+ * @example
+ * ```typescript
+ * import { createNebulaTransport } from 'agentic-mesh';
+ * import { MAPMeshPeer } from '@multi-agent-protocol/sdk';
+ *
+ * // Create transport
+ * const transport = createNebulaTransport({
+ *   configPath: '/etc/nebula/config.yml',
+ * });
+ *
+ * // Create mesh peer
+ * const peer = await MAPMeshPeer.create({
+ *   peerId: 'worker-1',
+ *   peerName: 'Worker Node 1',
+ *   transport,
+ *   git: {
+ *     enabled: true,
+ *     repoPath: '/workspace/project',
+ *   },
+ *   peers: [
+ *     { peerId: 'coordinator', address: '10.0.0.1', port: 4242 },
+ *   ],
+ * });
+ *
+ * // Start the peer
+ * await peer.start();
+ *
+ * // Create a local agent
+ * const agent = await peer.createAgent({
+ *   name: 'DataProcessor',
+ *   role: 'processor',
+ * });
+ *
+ * // Connect to another peer
+ * await peer.connectToPeer({ peerId: 'worker-2', address: '10.0.0.3' });
+ *
+ * // Sync code with connected peer
+ * await peer.git?.sync('worker-2', { branch: 'main' });
+ *
+ * // Clean shutdown
+ * await peer.stop();
+ * ```
+ */
+declare class MAPMeshPeer {
+    #private;
+    private constructor();
+    /**
+     * Create a new MAPMeshPeer.
+     *
+     * Requires `agentic-mesh` to be installed as a peer dependency.
+     *
+     * @param config - Peer configuration
+     * @returns Promise resolving to the created peer (not yet started)
+     */
+    static create(config: MAPMeshPeerConfig): Promise<MAPMeshPeer>;
+    /** Unique peer identifier */
+    get peerId(): string;
+    /** Display name for this peer */
+    get peerName(): string;
+    /** Whether the peer is currently running */
+    get isRunning(): boolean;
+    /** List of connected peer IDs */
+    get connectedPeers(): string[];
+    /** Git sync service (null if git not enabled) */
+    get git(): GitSyncService | null;
+    /**
+     * Start the mesh peer.
+     *
+     * This starts the transport, MAP server, and git service (if enabled),
+     * then connects to any initial peers specified in the config.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the mesh peer.
+     *
+     * This disconnects from all peers, unregisters all agents,
+     * stops the git service, MAP server, and transport.
+     */
+    stop(): Promise<void>;
+    /**
+     * Connect to a remote peer.
+     *
+     * After connecting, agents on both peers will be discoverable
+     * and messages can be routed between them.
+     *
+     * @param endpoint - Peer endpoint to connect to
+     */
+    connectToPeer(endpoint: PeerEndpoint): Promise<void>;
+    /**
+     * Disconnect from a peer.
+     *
+     * @param peerId - ID of peer to disconnect from
+     * @param reason - Optional reason for disconnecting
+     */
+    disconnectFromPeer(peerId: string, reason?: string): Promise<void>;
+    /**
+     * Check if connected to a specific peer.
+     *
+     * @param peerId - Peer ID to check
+     * @returns true if connected
+     */
+    isConnectedTo(peerId: string): boolean;
+    /**
+     * Create and register a local agent on this peer's MapServer.
+     *
+     * @param config - Agent configuration
+     * @returns The created agent
+     */
+    createAgent(config: CreateAgentConfig): Promise<LocalAgent>;
+    /**
+     * Get a local agent by ID.
+     *
+     * @param agentId - Agent ID to look up
+     * @returns The agent, or undefined if not found
+     */
+    getAgent(agentId: AgentId): LocalAgent | undefined;
+    /**
+     * Get all local agents on this peer.
+     */
+    getLocalAgents(): Agent[];
+    /**
+     * Get all known agents (local and discovered from connected peers).
+     */
+    getAllAgents(): Agent[];
+    /**
+     * Create a scope on this peer's MapServer.
+     *
+     * @param config - Scope configuration
+     * @returns The created scope
+     */
+    createScope(config: CreateScopeConfig): Scope;
+    /**
+     * Get a scope by ID.
+     *
+     * @param scopeId - Scope ID to look up
+     * @returns The scope, or undefined if not found
+     */
+    getScope(scopeId: ScopeId): Scope | undefined;
+    /**
+     * List all scopes on this peer.
+     */
+    listScopes(): Scope[];
+    /**
+     * Send a message from an agent to an address.
+     *
+     * Messages are routed to local agents or forwarded to connected peers.
+     *
+     * @param from - Sending agent ID
+     * @param to - Destination address
+     * @param payload - Message payload
+     * @param meta - Optional message metadata
+     * @returns Send result with delivery status
+     */
+    send(from: AgentId, to: Address, payload: unknown, meta?: MessageMeta): Promise<SendResult>;
+    /**
+     * Subscribe to events from this peer's MapServer.
+     *
+     * @param filter - Optional filter for event types
+     * @returns Event subscription
+     */
+    subscribe(filter?: SubscriptionFilter): MeshEventSubscription;
+    /**
+     * Register a handler for peer connection events.
+     *
+     * @param handler - Function called when a peer connects
+     * @returns Unsubscribe function
+     */
+    onPeerConnected(handler: (peerId: string, endpoint: PeerEndpoint) => void): () => void;
+    /**
+     * Register a handler for peer disconnection events.
+     *
+     * @param handler - Function called when a peer disconnects
+     * @returns Unsubscribe function
+     */
+    onPeerDisconnected(handler: (peerId: string, reason?: string) => void): () => void;
+    /**
+     * Register a handler for agent registration events.
+     *
+     * @param handler - Function called when an agent registers
+     * @returns Unsubscribe function
+     */
+    onAgentRegistered(handler: (agent: Agent) => void): () => void;
+    /**
+     * Register a handler for agent unregistration events.
+     *
+     * @param handler - Function called when an agent unregisters
+     * @returns Unsubscribe function
+     */
+    onAgentUnregistered(handler: (agent: Agent) => void): () => void;
+    /**
+     * Register a handler for error events.
+     *
+     * @param handler - Function called when an error occurs
+     * @returns Unsubscribe function
+     */
+    onError(handler: (error: Error) => void): () => void;
+}
+
+/**
+ * ACPAgentAdapter - Agent-side helper for ACP-over-MAP.
+ *
+ * Simplifies implementing ACP-compatible agents by handling the
+ * MAP↔ACP translation layer automatically.
+ *
+ * @module
+ */
+
+/**
+ * Adapter for implementing ACP-compatible agents.
+ *
+ * Handles the ACP envelope protocol, request routing, and provides
+ * helper methods for agent→client communication.
+ *
+ * @example
+ * ```typescript
+ * const mapAgent = await AgentConnection.connect('ws://localhost:8080', {
+ *   name: 'CodingAgent',
+ *   capabilities: { protocols: ['acp'], acp: { version: '2024-10-07' } }
+ * });
+ *
+ * const adapter = new ACPAgentAdapter(mapAgent, {
+ *   initialize: async (params, ctx) => ({
+ *     protocolVersion: 20241007,
+ *     agentInfo: { name: 'CodingAgent', version: '1.0.0' },
+ *     agentCapabilities: { loadSession: true }
+ *   }),
+ *   newSession: async (params, ctx) => ({
+ *     sessionId: generateId()
+ *   }),
+ *   prompt: async (params, ctx) => {
+ *     await adapter.sendSessionUpdate(ctx.streamId, {
+ *       sessionId: params.sessionId,
+ *       update: { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: 'Hello!' } }
+ *     });
+ *     return { stopReason: 'end_turn' };
+ *   },
+ *   cancel: async (params, ctx) => {}
+ * });
+ * ```
+ */
+declare class ACPAgentAdapter {
+    #private;
+    /**
+     * Create a new ACP agent adapter.
+     *
+     * @param mapAgent - The underlying MAP agent connection
+     * @param handler - Handler implementing ACP agent methods
+     * @param options - Optional configuration
+     */
+    constructor(mapAgent: AgentConnection, handler: ACPAgentHandler, options?: {
+        clientRequestTimeout?: number;
+    });
+    /**
+     * Send a session update notification to the client.
+     */
+    sendSessionUpdate(streamId: string, notification: ACPSessionNotification): Promise<void>;
+    /**
+     * Request permission from the client.
+     */
+    requestPermission(streamId: string, request: ACPRequestPermissionRequest): Promise<ACPRequestPermissionResponse>;
+    /**
+     * Read a text file from the client.
+     */
+    readTextFile(streamId: string, request: ACPReadTextFileRequest): Promise<ACPReadTextFileResponse>;
+    /**
+     * Write a text file on the client.
+     */
+    writeTextFile(streamId: string, request: ACPWriteTextFileRequest): Promise<ACPWriteTextFileResponse>;
+    /**
+     * Create a terminal on the client.
+     */
+    createTerminal(streamId: string, request: ACPCreateTerminalRequest): Promise<ACPCreateTerminalResponse>;
+    /**
+     * Get terminal output from the client.
+     */
+    terminalOutput(streamId: string, request: ACPTerminalOutputRequest): Promise<ACPTerminalOutputResponse>;
+    /**
+     * Release a terminal on the client.
+     */
+    releaseTerminal(streamId: string, request: ACPReleaseTerminalRequest): Promise<ACPReleaseTerminalResponse>;
+    /**
+     * Wait for a terminal to exit on the client.
+     */
+    waitForTerminalExit(streamId: string, request: ACPWaitForTerminalExitRequest): Promise<ACPWaitForTerminalExitResponse>;
+    /**
+     * Kill a terminal command on the client.
+     */
+    killTerminal(streamId: string, request: ACPKillTerminalCommandRequest): Promise<ACPKillTerminalCommandResponse>;
+    /**
+     * Get the current session ID for a stream.
+     */
+    getSessionId(streamId: string): ACPSessionId | null;
+    /**
+     * Get the client participant ID for a stream.
+     */
+    getClientParticipantId(streamId: string): ParticipantId | undefined;
+    /**
+     * Check if a stream is active.
+     */
+    hasStream(streamId: string): boolean;
+    /**
+     * Remove a stream context (e.g., on disconnect).
+     */
+    removeStream(streamId: string): boolean;
+}
+
+export { ACPAgentAdapter, ACPAgentHandler, ACPCreateTerminalRequest, ACPCreateTerminalResponse, ACPKillTerminalCommandRequest, ACPKillTerminalCommandResponse, ACPReadTextFileRequest, ACPReadTextFileResponse, ACPReleaseTerminalRequest, ACPReleaseTerminalResponse, ACPRequestPermissionRequest, ACPRequestPermissionResponse, ACPSessionId, ACPSessionNotification, ACPTerminalOutputRequest, ACPTerminalOutputResponse, ACPWaitForTerminalExitRequest, ACPWaitForTerminalExitResponse, ACPWriteTextFileRequest, ACPWriteTextFileResponse, Address, type AddressComponents, AddressSchema, type AddressType, type AddressValidated, Agent, AgentConnection, type AgentExposure, AgentId, AgentIdSchema, type AgentIdValidated, AgentLifecycleSchema, AgentRelationshipSchema, AgentSchema, AgentState, AgentStateSchema, type AgentStateValidated, type AgentValidated, AgentVisibility, AgentVisibilitySchema, AgentsGetResponseResult, AgentsListResponseResult, AgentsRegisterResponseResult, AgentsSpawnResponseResult, AgentsUnregisterResponseResult, AgentsUpdateResponseResult, BaseConnectionOptions, BroadcastAddressSchema, type CapabilityPath, type CausalBufferPushResult, type CausalEvent, CausalEventBuffer, type CausalEventBufferOptions, type CloneOptions, ConnectResponseResult, type ConnectedParticipant, ConnectionState, CorrelationIdSchema, type CreateAgentConfig, type CreateEnvelopeOptions, type CreateScopeConfig, DEFAULT_RETRY_POLICY, DeliverySemanticsSchema, DirectAddressSchema, DisconnectResponseResult, ErrorCategory, ErrorCategorySchema, Event, type EventExposure, EventSchema, EventType, EventTypeSchema, type EventValidated, FederatedAddressSchema, FederationBufferConfig, FederationConnectResponseResult, FederationEnvelope, FederationOutageBuffer, FederationRouteResponseResult, FederationRoutingConfig, GatewayConnection, type GatewayConnectionOptions, type GitSyncClient, type GitSyncService, HierarchicalAddressSchema, InvalidAddressError, JsonRpcVersionSchema, type LocalAgent, MAPConnectionError, MAPError, MAPErrorData, MAPErrorDataSchema, MAPErrorSchema, type MAPErrorValidated, MAPMeshPeer, type MAPMeshPeerConfig, type MAPMeshPeerEvents, MAPNotificationSchema, type MAPNotificationValidated, MAPRequestError, MAPRequestSchema, type MAPRequestValidated, MAPResponseErrorSchema, MAPResponseSchema, MAPResponseSuccessSchema, type MAPResponseValidated, type MAPRouter, type MAPRouterConfig, type MAPRouterFactory, MAPTimeoutError, METHOD_REGISTRY, type MeshEventSubscription, type MeshGitConfig, type MeshMapServerConfig, Message, MessageId, MessageIdSchema, type MessageIdValidated, MessageMeta, MessageMetaSchema, MessagePrioritySchema, MessageRelationshipSchema, MessageSchema, type MessageValidated, MessageVisibilitySchema, MetaSchema, type MethodCategory, type MethodInfo, MultiAddressSchema, ParticipantAddressSchema, ParticipantCapabilities, ParticipantCapabilitiesSchema, type ParticipantCapabilitiesValidated, ParticipantId, ParticipantIdSchema, type ParticipantIdValidated, ParticipantType, ParticipantTypeSchema, type ParticipantTypeValidated, type PeerBufferStats, type PeerEndpoint, type ProcessEnvelopeResult, ProtocolVersion, ProtocolVersionSchema, type PullOptions, type PushOptions, RequestId, RequestIdSchema, type RetryCallbacks, type RetryPolicy, type RetryState, RoleAddressSchema, type RouterLimits, Scope, ScopeAddressSchema, type ScopeExposure, ScopeId, ScopeIdSchema, type ScopeIdValidated, ScopeJoinPolicySchema, ScopeSchema, ScopeSendPolicySchema, type ScopeValidated, ScopeVisibility, ScopeVisibilitySchema, ScopesCreateResponseResult, ScopesJoinResponseResult, ScopesLeaveResponseResult, ScopesListResponseResult, SendResponseResult, type SendResult, SessionId, SessionIdSchema, type SessionIdValidated, SessionInfo, Stream, SubscribeResponseResult, SubscriptionFilter, SubscriptionFilterSchema, type SubscriptionFilterValidated, SubscriptionId, SubscriptionIdSchema, type SyncOptions, type SyncResult, SystemAddressSchema, type SystemExposure, TimestampSchema, type TransportAdapter, TransportTypeSchema, UnsubscribeResponseResult, buildAgentsGetResponse, buildAgentsListResponse, buildAgentsRegisterResponse, buildAgentsSpawnResponse, buildAgentsUnregisterResponse, buildAgentsUpdateResponse, buildConnectResponse, buildDisconnectResponse, buildScopesCreateResponse, buildScopesJoinResponse, buildScopesLeaveResponse, buildScopesListResponse, buildSendResponse, buildSubscribeResponse, buildUnsubscribeResponse, calculateDelay, compareUlid, createErrorResponse, createFederationEnvelope, createNotification, createRequest, createRetryPolicy, createSuccessResponse, extractId, extractType, formatAddress, getEnvelopeRoutingInfo, getMethodInfo, getMethodsByCategory, getRequiredCapabilities, hasRequiredCapabilities, isAddress, isAgentAddress, isEnvelopeAtDestination, isErrorResponse, isNotification, isRequest, isResponse, isScopeAddress, isValidEnvelope, isValidUlid, parseAddress, processFederationEnvelope, retryable, sleep, sortCausalOrder, toAgent, toScope, ulidTimestamp, unwrapEnvelope, validateCausalOrder, withPayload, withRetry };