@multi-agent-protocol/sdk 0.0.3 → 0.0.4

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-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-C7XPWnxS.cjs';
-export { O as AGENT_ERROR_CODES, Q as AUTH_ERROR_CODES, T as AUTH_METHODS, V as AcceptanceContext, W as AgentAcceptanceRule, X as AgentConnection, Y as AgentConnectionOptions, Z as AgentIncludeOptions, _ as AgentLifecycle, $ as AgentMessagingRule, a0 as AgentPermissionConfig, a1 as AgentPermissions, a2 as AgentReconnectionEventHandler, a3 as AgentReconnectionEventType, a4 as AgentReconnectionOptions, a5 as AgentRelationship, a6 as AgentRelationshipType, a7 as AgentState, a8 as AgentVisibility, a9 as AgentVisibilityRule, aa as AgentsGetRequest, ab as AgentsGetRequestParams, ac as AgentsListFilter, ad as AgentsListRequest, ae as AgentsListRequestParams, af as AgentsRegisterRequest, ag as AgentsRegisterRequestParams, ah as AgentsResumeRequest, ai as AgentsResumeRequestParams, aj as AgentsResumeResponseResult, ak as AgentsSpawnRequest, al as AgentsSpawnRequestParams, am as AgentsStopRequest, an as AgentsStopRequestParams, ao as AgentsStopResponseResult, ap as AgentsSuspendRequest, aq as AgentsSuspendRequestParams, ar as AgentsSuspendResponseResult, as as AgentsUnregisterRequest, at as AgentsUnregisterRequestParams, au as AgentsUpdateRequest, av as AgentsUpdateRequestParams, aw as AnyMessage, ax as AuthMethod, ay as AuthParams, az as AuthRefreshRequest, aA as AuthRefreshRequestParams, aB as AuthRefreshResponseResult, aC as BaseConnection, aD as BroadcastAddress, aE as CAPABILITY_REQUIREMENTS, aF as CORE_METHODS, aG as ClientAcceptanceRule, aH as ClientConnection, aI as ClientConnectionOptions, aJ as ConnectRequest, aK as ConnectRequestParams, aL as CorrelationId, aM as DEFAULT_AGENT_PERMISSION_CONFIG, aN as DeliverySemantics, aO as DirectAddress, aP as DisconnectPolicy, aQ as DisconnectRequest, aR as DisconnectRequestParams, aS as ERROR_CODES, aT as EVENT_TYPES, aU as EXTENSION_METHODS, aV as EventInput, aW as EventNotification, aX as EventNotificationParams, aY as FEDERATION_ERROR_CODES, aZ as FEDERATION_METHODS, a_ as FederatedAddress, a$ as FederationAuth, b0 as FederationConnectRequest, b1 as FederationConnectRequestParams, b2 as FederationMetadata, b3 as FederationReplayConfig, b4 as FederationRouteRequest, b5 as FederationRouteRequestParams, b6 as GatewayReconnectionEvent, b7 as GatewayReconnectionEventHandler, b8 as GatewayReconnectionEventType, b9 as GatewayReconnectionOptions, ba as GraphEdge, bb as HierarchicalAddress, bc as InjectDelivery, bd as InjectDeliveryResult, be as InjectRequest, bf as InjectRequestParams, bg as InjectResponseResult, bh as JSONRPC_VERSION, bi as JoinPolicy, bj as LIFECYCLE_METHODS, bk as MAPNotification, bl as MAPNotificationBase, bm as MAPRequest, bn as MAPRequestBase, bo as MAPResponse, bp as MAPResponseError, bq as MAPResponseSuccess, br as MAP_METHODS, bs as MessageDeliveredEventData, bt as MessageFailedEventData, bu as MessageHandler, bv as MessageMeta, bw as MessageNotification, bx as MessageNotificationParams, by as MessagePriority, bz as MessageRelationship, bA as MessageSentEventData, bB as MessageVisibility, bC as Meta, bD as MultiAddress, bE as NOTIFICATION_METHODS, bF as NotificationHandler, bG as OBSERVATION_METHODS, bH as OverflowHandler, bI as OverflowInfo, bJ as PERMISSION_METHODS, bK as PROTOCOL_ERROR_CODES, bL as PROTOCOL_VERSION, bM as Participant, bN as ParticipantAddress, bO as PermissionAction, bP as PermissionContext, bQ as PermissionParticipant, bR as PermissionResult, bS as PermissionSystemConfig, bT as PermissionsAgentUpdatedEventData, bU as PermissionsClientUpdatedEventData, bV as PermissionsUpdateRequest, bW as PermissionsUpdateRequestParams, bX as PermissionsUpdateResponseResult, bY as RESOURCE_ERROR_CODES, bZ as ROUTING_ERROR_CODES, b_ as ReconnectionEventHandler, b$ as ReconnectionEventType, c0 as ReconnectionOptions, c1 as ReplayRequest, c2 as ReplayRequestParams, c3 as ReplayResponseResult, c4 as ReplayedEvent, c5 as RequestHandler, c6 as RoleAddress, c7 as SCOPE_METHODS, c8 as SESSION_METHODS, c9 as STATE_METHODS, ca as STEERING_METHODS, cb as STRUCTURE_METHODS, cc as ScopeAddress, cd as ScopeMessagingRule, ce as ScopeVisibility, cf as ScopeVisibilityRule, cg as ScopesCreateRequest, ch as ScopesCreateRequestParams, ci as ScopesDeleteRequest, cj as ScopesDeleteRequestParams, ck as ScopesDeleteResponseResult, cl as ScopesGetRequest, cm as ScopesGetRequestParams, cn as ScopesGetResponseResult, co as ScopesJoinRequest, cp as ScopesJoinRequestParams, cq as ScopesLeaveRequest, cr as ScopesLeaveRequestParams, cs as ScopesListRequest, ct as ScopesListRequestParams, cu as ScopesMembersRequest, cv as ScopesMembersRequestParams, cw as ScopesMembersResponseResult, cx as SendPolicy, cy as SendRequest, cz as SendRequestParams, cA as SessionCloseRequest, cB as SessionCloseRequestParams, cC as SessionCloseResponseResult, cD as SessionListRequest, cE as SessionListRequestParams, cF as SessionListResponseResult, cG as SessionLoadRequest, cH as SessionLoadRequestParams, cI as SessionLoadResponseResult, cJ as StateChangeHandler, cK as StreamingCapabilities, cL as StructureGraphRequest, cM as StructureGraphRequestParams, cN as StructureGraphResponseResult, cO as StructureVisibilityRule, cP as SubscribeRequest, cQ as SubscribeRequestParams, cR as Subscription, cS as SubscriptionAckNotification, cT as SubscriptionAckParams, cU as SubscriptionOptions, cV as SubscriptionState, cW as SystemAcceptanceRule, cX as SystemAddress, cY as Timestamp, cZ as TransportType, c_ as UnsubscribeRequest, c$ as UnsubscribeRequestParams, d0 as canAgentAcceptMessage, d1 as canAgentMessageAgent, d2 as canAgentSeeAgent, d3 as canControlAgent, d4 as canJoinScope, d5 as canMessageAgent, d6 as canPerformAction, d7 as canPerformMethod, d8 as canSeeAgent, d9 as canSeeScope, da as canSendToScope, db as createEvent, dc as createStreamPair, dd as createSubscription, de as deepMergePermissions, df as filterVisibleAgents, dg as filterVisibleEvents, dh as filterVisibleScopes, di as hasCapability, dj as isAgentExposed, dk as isBroadcastAddress, dl as isDirectAddress, dm as isEventTypeExposed, dn as isFederatedAddress, dp as isHierarchicalAddress, dq as isOrphanedAgent, dr as isScopeAddress, ds as isScopeExposed, dt as isSuccessResponse, du as mapVisibilityToRule, dv as ndJsonStream, dw as resolveAgentPermissions, dx as websocketStream } from './index-C7XPWnxS.cjs';
+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.cjs';
+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.cjs';
 import { z } from 'zod';
 export { monotonicFactory, ulid } from 'ulid';
 
@@ -2017,6 +2017,12 @@ interface CausalEvent {
     /** Timestamp when the event was received */
     receivedAt?: number;
 }
+/**
+ * Mode for handling events with multiple causal dependencies.
+ * - "all": Wait for ALL causes before releasing (stricter, default)
+ * - "any": Release when ANY cause is seen (more permissive)
+ */
+type MultiCauseMode = "all" | "any";
 /**
  * Options for CausalEventBuffer
  */
@@ -2031,6 +2037,12 @@ interface CausalEventBufferOptions {
      * Default: 1000. Prevents unbounded memory growth.
      */
     maxBufferSize?: number;
+    /**
+     * Mode for handling events with multiple causes.
+     * - "all" (default): Wait for ALL causes before releasing
+     * - "any": Release when ANY cause is seen
+     */
+    multiCauseMode?: MultiCauseMode;
     /**
      * Callback when an event is released despite missing predecessors (timeout or buffer overflow).
      */
@@ -2077,6 +2089,10 @@ interface CausalBufferPushResult {
 declare class CausalEventBuffer {
     #private;
     constructor(options?: CausalEventBufferOptions);
+    /**
+     * Get the current multi-cause mode.
+     */
+    get multiCauseMode(): MultiCauseMode;
     /**
      * Push an event into the buffer.
      *
@@ -2285,4 +2301,110 @@ declare function isValidEnvelope(obj: unknown): obj is FederationEnvelope<unknow
  */
 declare function withPayload<T, U>(envelope: FederationEnvelope<T>, newPayload: U): FederationEnvelope<U>;
 
-export { Address, AddressSchema, 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, 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, getEnvelopeRoutingInfo, getMethodInfo, getMethodsByCategory, getRequiredCapabilities, hasRequiredCapabilities, isEnvelopeAtDestination, isErrorResponse, isNotification, isRequest, isResponse, isValidEnvelope, isValidUlid, processFederationEnvelope, retryable, sleep, sortCausalOrder, ulidTimestamp, unwrapEnvelope, validateCausalOrder, withPayload, withRetry };
+/**
+ * Address utilities for recipient disambiguation
+ *
+ * Provides utilities for parsing and formatting message addresses
+ * with type prefixes to distinguish between agent and scope recipients.
+ *
+ * Format: "{type}:{id}"
+ * - agent:abc123  -> agent recipient
+ * - scope:room-1  -> scope recipient
+ */
+/** Valid address types */
+type AddressType = "agent" | "scope";
+/** Parsed address components */
+interface AddressComponents {
+    type: AddressType;
+    id: string;
+}
+/**
+ * Error thrown when an address format is invalid.
+ */
+declare class InvalidAddressError extends Error {
+    constructor(address: string, reason: string);
+}
+/**
+ * Format an address with type prefix.
+ *
+ * @param type - The address type (agent or scope)
+ * @param id - The entity ID
+ * @returns Formatted address string
+ * @throws InvalidAddressError if parameters are invalid
+ *
+ * @example
+ * formatAddress("agent", "abc123")  // "agent:abc123"
+ * formatAddress("scope", "room-1")  // "scope:room-1"
+ */
+declare function formatAddress(type: AddressType, id: string): string;
+/**
+ * Parse an address string into its components.
+ *
+ * @param address - The address string to parse
+ * @returns Parsed address components
+ * @throws InvalidAddressError if format is invalid
+ *
+ * @example
+ * parseAddress("agent:abc123")  // { type: "agent", id: "abc123" }
+ * parseAddress("scope:room-1")  // { type: "scope", id: "room-1" }
+ */
+declare function parseAddress(address: string): AddressComponents;
+/**
+ * Check if a string is a valid prefixed address.
+ *
+ * @param address - The string to check
+ * @returns true if valid prefixed address format
+ *
+ * @example
+ * isAddress("agent:abc123")  // true
+ * isAddress("scope:room-1")  // true
+ * isAddress("abc123")        // false (no prefix)
+ * isAddress("invalid:abc")   // false (invalid type)
+ */
+declare function isAddress(address: string): boolean;
+/**
+ * Check if an address is for an agent.
+ *
+ * @param address - The address string to check
+ * @returns true if address is for an agent
+ */
+declare function isAgentAddress(address: string): boolean;
+/**
+ * Check if an address is for a scope.
+ *
+ * @param address - The address string to check
+ * @returns true if address is for a scope
+ */
+declare function isScopeAddress(address: string): boolean;
+/**
+ * Extract the ID from an address, or return the original if not prefixed.
+ *
+ * Useful for backward compatibility when handling both prefixed and unprefixed addresses.
+ *
+ * @param address - The address string
+ * @returns The extracted ID or the original string
+ */
+declare function extractId(address: string): string;
+/**
+ * Extract the type from an address, or return undefined if not prefixed.
+ *
+ * @param address - The address string
+ * @returns The address type or undefined
+ */
+declare function extractType(address: string): AddressType | undefined;
+/**
+ * Convenience function to create an agent address.
+ *
+ * @param agentId - The agent ID
+ * @returns Formatted agent address
+ */
+declare function toAgent(agentId: string): string;
+/**
+ * Convenience function to create a scope address.
+ *
+ * @param scopeId - The scope ID
+ * @returns Formatted scope address
+ */
+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 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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-C7XPWnxS.js';
-export { O as AGENT_ERROR_CODES, Q as AUTH_ERROR_CODES, T as AUTH_METHODS, V as AcceptanceContext, W as AgentAcceptanceRule, X as AgentConnection, Y as AgentConnectionOptions, Z as AgentIncludeOptions, _ as AgentLifecycle, $ as AgentMessagingRule, a0 as AgentPermissionConfig, a1 as AgentPermissions, a2 as AgentReconnectionEventHandler, a3 as AgentReconnectionEventType, a4 as AgentReconnectionOptions, a5 as AgentRelationship, a6 as AgentRelationshipType, a7 as AgentState, a8 as AgentVisibility, a9 as AgentVisibilityRule, aa as AgentsGetRequest, ab as AgentsGetRequestParams, ac as AgentsListFilter, ad as AgentsListRequest, ae as AgentsListRequestParams, af as AgentsRegisterRequest, ag as AgentsRegisterRequestParams, ah as AgentsResumeRequest, ai as AgentsResumeRequestParams, aj as AgentsResumeResponseResult, ak as AgentsSpawnRequest, al as AgentsSpawnRequestParams, am as AgentsStopRequest, an as AgentsStopRequestParams, ao as AgentsStopResponseResult, ap as AgentsSuspendRequest, aq as AgentsSuspendRequestParams, ar as AgentsSuspendResponseResult, as as AgentsUnregisterRequest, at as AgentsUnregisterRequestParams, au as AgentsUpdateRequest, av as AgentsUpdateRequestParams, aw as AnyMessage, ax as AuthMethod, ay as AuthParams, az as AuthRefreshRequest, aA as AuthRefreshRequestParams, aB as AuthRefreshResponseResult, aC as BaseConnection, aD as BroadcastAddress, aE as CAPABILITY_REQUIREMENTS, aF as CORE_METHODS, aG as ClientAcceptanceRule, aH as ClientConnection, aI as ClientConnectionOptions, aJ as ConnectRequest, aK as ConnectRequestParams, aL as CorrelationId, aM as DEFAULT_AGENT_PERMISSION_CONFIG, aN as DeliverySemantics, aO as DirectAddress, aP as DisconnectPolicy, aQ as DisconnectRequest, aR as DisconnectRequestParams, aS as ERROR_CODES, aT as EVENT_TYPES, aU as EXTENSION_METHODS, aV as EventInput, aW as EventNotification, aX as EventNotificationParams, aY as FEDERATION_ERROR_CODES, aZ as FEDERATION_METHODS, a_ as FederatedAddress, a$ as FederationAuth, b0 as FederationConnectRequest, b1 as FederationConnectRequestParams, b2 as FederationMetadata, b3 as FederationReplayConfig, b4 as FederationRouteRequest, b5 as FederationRouteRequestParams, b6 as GatewayReconnectionEvent, b7 as GatewayReconnectionEventHandler, b8 as GatewayReconnectionEventType, b9 as GatewayReconnectionOptions, ba as GraphEdge, bb as HierarchicalAddress, bc as InjectDelivery, bd as InjectDeliveryResult, be as InjectRequest, bf as InjectRequestParams, bg as InjectResponseResult, bh as JSONRPC_VERSION, bi as JoinPolicy, bj as LIFECYCLE_METHODS, bk as MAPNotification, bl as MAPNotificationBase, bm as MAPRequest, bn as MAPRequestBase, bo as MAPResponse, bp as MAPResponseError, bq as MAPResponseSuccess, br as MAP_METHODS, bs as MessageDeliveredEventData, bt as MessageFailedEventData, bu as MessageHandler, bv as MessageMeta, bw as MessageNotification, bx as MessageNotificationParams, by as MessagePriority, bz as MessageRelationship, bA as MessageSentEventData, bB as MessageVisibility, bC as Meta, bD as MultiAddress, bE as NOTIFICATION_METHODS, bF as NotificationHandler, bG as OBSERVATION_METHODS, bH as OverflowHandler, bI as OverflowInfo, bJ as PERMISSION_METHODS, bK as PROTOCOL_ERROR_CODES, bL as PROTOCOL_VERSION, bM as Participant, bN as ParticipantAddress, bO as PermissionAction, bP as PermissionContext, bQ as PermissionParticipant, bR as PermissionResult, bS as PermissionSystemConfig, bT as PermissionsAgentUpdatedEventData, bU as PermissionsClientUpdatedEventData, bV as PermissionsUpdateRequest, bW as PermissionsUpdateRequestParams, bX as PermissionsUpdateResponseResult, bY as RESOURCE_ERROR_CODES, bZ as ROUTING_ERROR_CODES, b_ as ReconnectionEventHandler, b$ as ReconnectionEventType, c0 as ReconnectionOptions, c1 as ReplayRequest, c2 as ReplayRequestParams, c3 as ReplayResponseResult, c4 as ReplayedEvent, c5 as RequestHandler, c6 as RoleAddress, c7 as SCOPE_METHODS, c8 as SESSION_METHODS, c9 as STATE_METHODS, ca as STEERING_METHODS, cb as STRUCTURE_METHODS, cc as ScopeAddress, cd as ScopeMessagingRule, ce as ScopeVisibility, cf as ScopeVisibilityRule, cg as ScopesCreateRequest, ch as ScopesCreateRequestParams, ci as ScopesDeleteRequest, cj as ScopesDeleteRequestParams, ck as ScopesDeleteResponseResult, cl as ScopesGetRequest, cm as ScopesGetRequestParams, cn as ScopesGetResponseResult, co as ScopesJoinRequest, cp as ScopesJoinRequestParams, cq as ScopesLeaveRequest, cr as ScopesLeaveRequestParams, cs as ScopesListRequest, ct as ScopesListRequestParams, cu as ScopesMembersRequest, cv as ScopesMembersRequestParams, cw as ScopesMembersResponseResult, cx as SendPolicy, cy as SendRequest, cz as SendRequestParams, cA as SessionCloseRequest, cB as SessionCloseRequestParams, cC as SessionCloseResponseResult, cD as SessionListRequest, cE as SessionListRequestParams, cF as SessionListResponseResult, cG as SessionLoadRequest, cH as SessionLoadRequestParams, cI as SessionLoadResponseResult, cJ as StateChangeHandler, cK as StreamingCapabilities, cL as StructureGraphRequest, cM as StructureGraphRequestParams, cN as StructureGraphResponseResult, cO as StructureVisibilityRule, cP as SubscribeRequest, cQ as SubscribeRequestParams, cR as Subscription, cS as SubscriptionAckNotification, cT as SubscriptionAckParams, cU as SubscriptionOptions, cV as SubscriptionState, cW as SystemAcceptanceRule, cX as SystemAddress, cY as Timestamp, cZ as TransportType, c_ as UnsubscribeRequest, c$ as UnsubscribeRequestParams, d0 as canAgentAcceptMessage, d1 as canAgentMessageAgent, d2 as canAgentSeeAgent, d3 as canControlAgent, d4 as canJoinScope, d5 as canMessageAgent, d6 as canPerformAction, d7 as canPerformMethod, d8 as canSeeAgent, d9 as canSeeScope, da as canSendToScope, db as createEvent, dc as createStreamPair, dd as createSubscription, de as deepMergePermissions, df as filterVisibleAgents, dg as filterVisibleEvents, dh as filterVisibleScopes, di as hasCapability, dj as isAgentExposed, dk as isBroadcastAddress, dl as isDirectAddress, dm as isEventTypeExposed, dn as isFederatedAddress, dp as isHierarchicalAddress, dq as isOrphanedAgent, dr as isScopeAddress, ds as isScopeExposed, dt as isSuccessResponse, du as mapVisibilityToRule, dv as ndJsonStream, dw as resolveAgentPermissions, dx as websocketStream } from './index-C7XPWnxS.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 } 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 { z } from 'zod';
 export { monotonicFactory, ulid } from 'ulid';
 
@@ -2017,6 +2017,12 @@ interface CausalEvent {
     /** Timestamp when the event was received */
     receivedAt?: number;
 }
+/**
+ * Mode for handling events with multiple causal dependencies.
+ * - "all": Wait for ALL causes before releasing (stricter, default)
+ * - "any": Release when ANY cause is seen (more permissive)
+ */
+type MultiCauseMode = "all" | "any";
 /**
  * Options for CausalEventBuffer
  */
@@ -2031,6 +2037,12 @@ interface CausalEventBufferOptions {
      * Default: 1000. Prevents unbounded memory growth.
      */
     maxBufferSize?: number;
+    /**
+     * Mode for handling events with multiple causes.
+     * - "all" (default): Wait for ALL causes before releasing
+     * - "any": Release when ANY cause is seen
+     */
+    multiCauseMode?: MultiCauseMode;
     /**
      * Callback when an event is released despite missing predecessors (timeout or buffer overflow).
      */
@@ -2077,6 +2089,10 @@ interface CausalBufferPushResult {
 declare class CausalEventBuffer {
     #private;
     constructor(options?: CausalEventBufferOptions);
+    /**
+     * Get the current multi-cause mode.
+     */
+    get multiCauseMode(): MultiCauseMode;
     /**
      * Push an event into the buffer.
      *
@@ -2285,4 +2301,110 @@ declare function isValidEnvelope(obj: unknown): obj is FederationEnvelope<unknow
  */
 declare function withPayload<T, U>(envelope: FederationEnvelope<T>, newPayload: U): FederationEnvelope<U>;
 
-export { Address, AddressSchema, 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, 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, getEnvelopeRoutingInfo, getMethodInfo, getMethodsByCategory, getRequiredCapabilities, hasRequiredCapabilities, isEnvelopeAtDestination, isErrorResponse, isNotification, isRequest, isResponse, isValidEnvelope, isValidUlid, processFederationEnvelope, retryable, sleep, sortCausalOrder, ulidTimestamp, unwrapEnvelope, validateCausalOrder, withPayload, withRetry };
+/**
+ * Address utilities for recipient disambiguation
+ *
+ * Provides utilities for parsing and formatting message addresses
+ * with type prefixes to distinguish between agent and scope recipients.
+ *
+ * Format: "{type}:{id}"
+ * - agent:abc123  -> agent recipient
+ * - scope:room-1  -> scope recipient
+ */
+/** Valid address types */
+type AddressType = "agent" | "scope";
+/** Parsed address components */
+interface AddressComponents {
+    type: AddressType;
+    id: string;
+}
+/**
+ * Error thrown when an address format is invalid.
+ */
+declare class InvalidAddressError extends Error {
+    constructor(address: string, reason: string);
+}
+/**
+ * Format an address with type prefix.
+ *
+ * @param type - The address type (agent or scope)
+ * @param id - The entity ID
+ * @returns Formatted address string
+ * @throws InvalidAddressError if parameters are invalid
+ *
+ * @example
+ * formatAddress("agent", "abc123")  // "agent:abc123"
+ * formatAddress("scope", "room-1")  // "scope:room-1"
+ */
+declare function formatAddress(type: AddressType, id: string): string;
+/**
+ * Parse an address string into its components.
+ *
+ * @param address - The address string to parse
+ * @returns Parsed address components
+ * @throws InvalidAddressError if format is invalid
+ *
+ * @example
+ * parseAddress("agent:abc123")  // { type: "agent", id: "abc123" }
+ * parseAddress("scope:room-1")  // { type: "scope", id: "room-1" }
+ */
+declare function parseAddress(address: string): AddressComponents;
+/**
+ * Check if a string is a valid prefixed address.
+ *
+ * @param address - The string to check
+ * @returns true if valid prefixed address format
+ *
+ * @example
+ * isAddress("agent:abc123")  // true
+ * isAddress("scope:room-1")  // true
+ * isAddress("abc123")        // false (no prefix)
+ * isAddress("invalid:abc")   // false (invalid type)
+ */
+declare function isAddress(address: string): boolean;
+/**
+ * Check if an address is for an agent.
+ *
+ * @param address - The address string to check
+ * @returns true if address is for an agent
+ */
+declare function isAgentAddress(address: string): boolean;
+/**
+ * Check if an address is for a scope.
+ *
+ * @param address - The address string to check
+ * @returns true if address is for a scope
+ */
+declare function isScopeAddress(address: string): boolean;
+/**
+ * Extract the ID from an address, or return the original if not prefixed.
+ *
+ * Useful for backward compatibility when handling both prefixed and unprefixed addresses.
+ *
+ * @param address - The address string
+ * @returns The extracted ID or the original string
+ */
+declare function extractId(address: string): string;
+/**
+ * Extract the type from an address, or return undefined if not prefixed.
+ *
+ * @param address - The address string
+ * @returns The address type or undefined
+ */
+declare function extractType(address: string): AddressType | undefined;
+/**
+ * Convenience function to create an agent address.
+ *
+ * @param agentId - The agent ID
+ * @returns Formatted agent address
+ */
+declare function toAgent(agentId: string): string;
+/**
+ * Convenience function to create a scope address.
+ *
+ * @param scopeId - The scope ID
+ * @returns Formatted scope address
+ */
+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 };