@multi-agent-protocol/sdk 0.0.7 → 0.0.8

package/dist/index.cjs

@@ -113,7 +113,16 @@ var EVENT_TYPES = {
   SYSTEM_ERROR: "system_error",
   // Federation events
   FEDERATION_CONNECTED: "federation_connected",
-  FEDERATION_DISCONNECTED: "federation_disconnected"
+  FEDERATION_DISCONNECTED: "federation_disconnected",
+  // Mail events
+  MAIL_CREATED: "mail.created",
+  MAIL_CLOSED: "mail.closed",
+  MAIL_PARTICIPANT_JOINED: "mail.participant.joined",
+  MAIL_PARTICIPANT_LEFT: "mail.participant.left",
+  MAIL_TURN_ADDED: "mail.turn.added",
+  MAIL_TURN_UPDATED: "mail.turn.updated",
+  MAIL_THREAD_CREATED: "mail.thread.created",
+  MAIL_SUMMARY_GENERATED: "mail.summary.generated"
 };
 function createEvent(input) {
   return {
@@ -179,6 +188,21 @@ var FEDERATION_METHODS = {
   FEDERATION_CONNECT: "map/federation/connect",
   FEDERATION_ROUTE: "map/federation/route"
 };
+var MAIL_METHODS = {
+  MAIL_CREATE: "mail/create",
+  MAIL_GET: "mail/get",
+  MAIL_LIST: "mail/list",
+  MAIL_CLOSE: "mail/close",
+  MAIL_JOIN: "mail/join",
+  MAIL_LEAVE: "mail/leave",
+  MAIL_INVITE: "mail/invite",
+  MAIL_TURN: "mail/turn",
+  MAIL_TURNS_LIST: "mail/turns/list",
+  MAIL_THREAD_CREATE: "mail/thread/create",
+  MAIL_THREAD_LIST: "mail/thread/list",
+  MAIL_SUMMARY: "mail/summary",
+  MAIL_REPLAY: "mail/replay"
+};
 var NOTIFICATION_METHODS = {
   EVENT: "map/event",
   MESSAGE: "map/message",
@@ -197,7 +221,8 @@ var MAP_METHODS = {
   ...SESSION_METHODS,
   ...AUTH_METHODS,
   ...PERMISSION_METHODS,
-  ...FEDERATION_METHODS
+  ...FEDERATION_METHODS,
+  ...MAIL_METHODS
 };
 var STRUCTURE_METHODS = {
   ...LIFECYCLE_METHODS,
@@ -254,13 +279,27 @@ var FEDERATION_ERROR_CODES = {
   /** Message exceeded maximum hop count */
   FEDERATION_MAX_HOPS_EXCEEDED: 5011
 };
+var MAIL_ERROR_CODES = {
+  MAIL_CONVERSATION_NOT_FOUND: 1e4,
+  MAIL_CONVERSATION_CLOSED: 10001,
+  MAIL_NOT_A_PARTICIPANT: 10002,
+  MAIL_PERMISSION_DENIED: 10003,
+  MAIL_TURN_NOT_FOUND: 10004,
+  MAIL_THREAD_NOT_FOUND: 10005,
+  MAIL_INVALID_TURN_CONTENT: 10006,
+  MAIL_PARTICIPANT_ALREADY_JOINED: 10007,
+  MAIL_INVITATION_REQUIRED: 10008,
+  MAIL_HISTORY_ACCESS_DENIED: 10009,
+  MAIL_PARENT_CONVERSATION_NOT_FOUND: 10010
+};
 var ERROR_CODES = {
   ...PROTOCOL_ERROR_CODES,
   ...AUTH_ERROR_CODES,
   ...ROUTING_ERROR_CODES,
   ...AGENT_ERROR_CODES,
   ...RESOURCE_ERROR_CODES,
-  ...FEDERATION_ERROR_CODES
+  ...FEDERATION_ERROR_CODES,
+  ...MAIL_ERROR_CODES
 };
 var PROTOCOL_VERSION = 1;
 var CAPABILITY_REQUIREMENTS = {
@@ -304,7 +343,21 @@ var CAPABILITY_REQUIREMENTS = {
   [PERMISSION_METHODS.PERMISSIONS_UPDATE]: [],
   // Federation
   [FEDERATION_METHODS.FEDERATION_CONNECT]: ["federation.canFederate"],
-  [FEDERATION_METHODS.FEDERATION_ROUTE]: ["federation.canFederate"]
+  [FEDERATION_METHODS.FEDERATION_ROUTE]: ["federation.canFederate"],
+  // Mail
+  [MAIL_METHODS.MAIL_CREATE]: ["mail.canCreate"],
+  [MAIL_METHODS.MAIL_GET]: ["mail.canJoin"],
+  [MAIL_METHODS.MAIL_LIST]: ["mail.canJoin"],
+  [MAIL_METHODS.MAIL_CLOSE]: ["mail.canCreate"],
+  [MAIL_METHODS.MAIL_JOIN]: ["mail.canJoin"],
+  [MAIL_METHODS.MAIL_LEAVE]: ["mail.canJoin"],
+  [MAIL_METHODS.MAIL_INVITE]: ["mail.canInvite"],
+  [MAIL_METHODS.MAIL_TURN]: ["mail.canJoin"],
+  [MAIL_METHODS.MAIL_TURNS_LIST]: ["mail.canViewHistory"],
+  [MAIL_METHODS.MAIL_THREAD_CREATE]: ["mail.canCreateThreads"],
+  [MAIL_METHODS.MAIL_THREAD_LIST]: ["mail.canJoin"],
+  [MAIL_METHODS.MAIL_SUMMARY]: ["mail.canViewHistory"],
+  [MAIL_METHODS.MAIL_REPLAY]: ["mail.canViewHistory"]
 };
 function isSuccessResponse(response) {
   return "result" in response;
@@ -3262,6 +3315,187 @@ var ClientConnection = class _ClientConnection {
     return this.#connection.sendRequest(STATE_METHODS.AGENTS_RESUME, { agentId });
   }
   // ===========================================================================
+  // Mail
+  // ===========================================================================
+  /**
+   * Create a new mail conversation.
+   *
+   * @param params - Conversation creation parameters
+   * @returns Created conversation and participant info
+   */
+  async createConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_CREATE,
+      params ?? {}
+    );
+  }
+  /**
+   * Get a conversation by ID with optional includes.
+   *
+   * @param conversationId - ID of the conversation to retrieve
+   * @param include - Optional fields to include (participants, threads, recentTurns, stats)
+   * @returns Conversation details with requested includes
+   */
+  async getConversation(conversationId, include) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_GET,
+      { conversationId, include }
+    );
+  }
+  /**
+   * List conversations with optional filters.
+   *
+   * @param params - Optional filter, limit, and cursor parameters
+   * @returns Paginated list of conversations
+   */
+  async listConversations(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_LIST,
+      params ?? {}
+    );
+  }
+  /**
+   * Close a conversation.
+   *
+   * @param conversationId - ID of the conversation to close
+   * @param reason - Optional reason for closing
+   * @returns The closed conversation
+   */
+  async closeConversation(conversationId, reason) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_CLOSE,
+      { conversationId, reason }
+    );
+  }
+  /**
+   * Join an existing conversation.
+   *
+   * @param params - Join parameters including conversationId and optional catch-up config
+   * @returns Conversation, participant, and optional history
+   */
+  async joinConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_JOIN,
+      params
+    );
+  }
+  /**
+   * Leave a conversation.
+   *
+   * @param conversationId - ID of the conversation to leave
+   * @param reason - Optional reason for leaving
+   * @returns Leave confirmation with timestamp
+   */
+  async leaveConversation(conversationId, reason) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_LEAVE,
+      { conversationId, reason }
+    );
+  }
+  /**
+   * Invite a participant to a conversation.
+   *
+   * @param params - Invite parameters including conversationId and participant info
+   * @returns Invite result
+   */
+  async inviteToConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_INVITE,
+      params
+    );
+  }
+  /**
+   * Record a turn (message) in a conversation.
+   *
+   * @param params - Turn parameters including conversationId, contentType, and content
+   * @returns The created turn
+   */
+  async recordTurn(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_TURN,
+      params
+    );
+  }
+  /**
+   * List turns in a conversation with optional filters.
+   *
+   * @param params - List parameters including conversationId and optional filters
+   * @returns Paginated list of turns
+   */
+  async listTurns(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_TURNS_LIST,
+      params
+    );
+  }
+  /**
+   * Create a thread in a conversation.
+   *
+   * @param params - Thread creation parameters including conversationId and rootTurnId
+   * @returns The created thread
+   */
+  async createThread(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_THREAD_CREATE,
+      params
+    );
+  }
+  /**
+   * List threads in a conversation.
+   *
+   * @param params - List parameters including conversationId
+   * @returns Paginated list of threads
+   */
+  async listThreads(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_THREAD_LIST,
+      params
+    );
+  }
+  /**
+   * Get a summary of a conversation.
+   *
+   * @param params - Summary parameters including conversationId and optional scope/includes
+   * @returns Generated summary with optional key points, decisions, and questions
+   */
+  async getConversationSummary(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_SUMMARY,
+      params
+    );
+  }
+  /**
+   * Replay turns from a conversation, optionally from a specific point.
+   *
+   * @param params - Replay parameters including conversationId and optional starting point
+   * @returns Replayed turns with pagination info
+   */
+  async replayConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_REPLAY,
+      params
+    );
+  }
+  /**
+   * Send a message to an address with mail context attached.
+   *
+   * Wraps the standard `send()` method, automatically attaching `meta.mail`
+   * with the specified conversationId so the message is recorded as a turn
+   * in the conversation.
+   *
+   * @param to - Target address
+   * @param payload - Message payload
+   * @param conversationId - Conversation to associate with
+   * @param options - Optional threadId and additional message meta
+   * @returns Send result
+   */
+  async sendWithMail(to, payload, conversationId, options) {
+    return this.send(to, payload, {
+      ...options?.meta,
+      mail: { conversationId, threadId: options?.threadId }
+    });
+  }
+  // ===========================================================================
   // Reconnection
   // ===========================================================================
   /**
@@ -4032,6 +4266,187 @@ var AgentConnection = class _AgentConnection {
     return this.#connection.onStateChange(handler);
   }
   // ===========================================================================
+  // Mail
+  // ===========================================================================
+  /**
+   * Create a new mail conversation.
+   *
+   * @param params - Conversation creation parameters
+   * @returns Created conversation and participant info
+   */
+  async createConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_CREATE,
+      params ?? {}
+    );
+  }
+  /**
+   * Get a conversation by ID with optional includes.
+   *
+   * @param conversationId - ID of the conversation to retrieve
+   * @param include - Optional fields to include (participants, threads, recentTurns, stats)
+   * @returns Conversation details with requested includes
+   */
+  async getConversation(conversationId, include) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_GET,
+      { conversationId, include }
+    );
+  }
+  /**
+   * List conversations with optional filters.
+   *
+   * @param params - Optional filter, limit, and cursor parameters
+   * @returns Paginated list of conversations
+   */
+  async listConversations(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_LIST,
+      params ?? {}
+    );
+  }
+  /**
+   * Close a conversation.
+   *
+   * @param conversationId - ID of the conversation to close
+   * @param reason - Optional reason for closing
+   * @returns The closed conversation
+   */
+  async closeConversation(conversationId, reason) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_CLOSE,
+      { conversationId, reason }
+    );
+  }
+  /**
+   * Join an existing conversation.
+   *
+   * @param params - Join parameters including conversationId and optional catch-up config
+   * @returns Conversation, participant, and optional history
+   */
+  async joinConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_JOIN,
+      params
+    );
+  }
+  /**
+   * Leave a conversation.
+   *
+   * @param conversationId - ID of the conversation to leave
+   * @param reason - Optional reason for leaving
+   * @returns Leave confirmation with timestamp
+   */
+  async leaveConversation(conversationId, reason) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_LEAVE,
+      { conversationId, reason }
+    );
+  }
+  /**
+   * Invite a participant to a conversation.
+   *
+   * @param params - Invite parameters including conversationId and participant info
+   * @returns Invite result
+   */
+  async inviteToConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_INVITE,
+      params
+    );
+  }
+  /**
+   * Record a turn (message) in a conversation.
+   *
+   * @param params - Turn parameters including conversationId, contentType, and content
+   * @returns The created turn
+   */
+  async recordTurn(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_TURN,
+      params
+    );
+  }
+  /**
+   * List turns in a conversation with optional filters.
+   *
+   * @param params - List parameters including conversationId and optional filters
+   * @returns Paginated list of turns
+   */
+  async listTurns(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_TURNS_LIST,
+      params
+    );
+  }
+  /**
+   * Create a thread in a conversation.
+   *
+   * @param params - Thread creation parameters including conversationId and rootTurnId
+   * @returns The created thread
+   */
+  async createThread(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_THREAD_CREATE,
+      params
+    );
+  }
+  /**
+   * List threads in a conversation.
+   *
+   * @param params - List parameters including conversationId
+   * @returns Paginated list of threads
+   */
+  async listThreads(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_THREAD_LIST,
+      params
+    );
+  }
+  /**
+   * Get a summary of a conversation.
+   *
+   * @param params - Summary parameters including conversationId and optional scope/includes
+   * @returns Generated summary with optional key points, decisions, and questions
+   */
+  async getConversationSummary(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_SUMMARY,
+      params
+    );
+  }
+  /**
+   * Replay turns from a conversation, optionally from a specific point.
+   *
+   * @param params - Replay parameters including conversationId and optional starting point
+   * @returns Replayed turns with pagination info
+   */
+  async replayConversation(params) {
+    return this.#connection.sendRequest(
+      MAIL_METHODS.MAIL_REPLAY,
+      params
+    );
+  }
+  /**
+   * Send a message to an agent with mail context attached.
+   *
+   * Wraps the standard `send()` method, automatically attaching `meta.mail`
+   * with the specified conversationId so the message is recorded as a turn
+   * in the conversation.
+   *
+   * @param to - Target address
+   * @param payload - Message payload
+   * @param conversationId - Conversation to associate with
+   * @param options - Optional threadId and additional message meta
+   * @returns Send result
+   */
+  async sendWithMail(to, payload, conversationId, options) {
+    return this.send(to, payload, {
+      ...options?.meta,
+      mail: { conversationId, threadId: options?.threadId }
+    });
+  }
+  // ===========================================================================
   // Internal
   // ===========================================================================
   /**
@@ -5228,6 +5643,85 @@ var METHOD_REGISTRY = {
     capabilities: ["federation.canFederate"],
     description: "Route message to federated system"
   },
+  // Mail methods
+  "mail/create": {
+    method: "mail/create",
+    category: "mail",
+    capabilities: ["mail.canCreate"],
+    description: "Create a new conversation"
+  },
+  "mail/get": {
+    method: "mail/get",
+    category: "mail",
+    capabilities: ["mail.canJoin"],
+    description: "Get conversation details"
+  },
+  "mail/list": {
+    method: "mail/list",
+    category: "mail",
+    capabilities: ["mail.canJoin"],
+    description: "List conversations"
+  },
+  "mail/close": {
+    method: "mail/close",
+    category: "mail",
+    capabilities: ["mail.canCreate"],
+    description: "Close a conversation"
+  },
+  "mail/join": {
+    method: "mail/join",
+    category: "mail",
+    capabilities: ["mail.canJoin"],
+    description: "Join an existing conversation"
+  },
+  "mail/leave": {
+    method: "mail/leave",
+    category: "mail",
+    capabilities: ["mail.canJoin"],
+    description: "Leave a conversation"
+  },
+  "mail/invite": {
+    method: "mail/invite",
+    category: "mail",
+    capabilities: ["mail.canInvite"],
+    description: "Invite a participant to a conversation"
+  },
+  "mail/turn": {
+    method: "mail/turn",
+    category: "mail",
+    capabilities: ["mail.canJoin"],
+    description: "Record a turn in a conversation"
+  },
+  "mail/turns/list": {
+    method: "mail/turns/list",
+    category: "mail",
+    capabilities: ["mail.canViewHistory"],
+    description: "List turns in a conversation"
+  },
+  "mail/thread/create": {
+    method: "mail/thread/create",
+    category: "mail",
+    capabilities: ["mail.canCreateThreads"],
+    description: "Create a thread within a conversation"
+  },
+  "mail/thread/list": {
+    method: "mail/thread/list",
+    category: "mail",
+    capabilities: ["mail.canJoin"],
+    description: "List threads in a conversation"
+  },
+  "mail/summary": {
+    method: "mail/summary",
+    category: "mail",
+    capabilities: ["mail.canViewHistory"],
+    description: "Get or generate a conversation summary"
+  },
+  "mail/replay": {
+    method: "mail/replay",
+    category: "mail",
+    capabilities: ["mail.canViewHistory"],
+    description: "Replay turns from a specific point"
+  },
   // Notification methods (client → server)
   "subscription/ack": {
     method: "map/subscribe.ack",
@@ -6452,6 +6946,8 @@ exports.InvalidAddressError = InvalidAddressError;
 exports.JSONRPC_VERSION = JSONRPC_VERSION;
 exports.JsonRpcVersionSchema = JsonRpcVersionSchema;
 exports.LIFECYCLE_METHODS = LIFECYCLE_METHODS;
+exports.MAIL_ERROR_CODES = MAIL_ERROR_CODES;
+exports.MAIL_METHODS = MAIL_METHODS;
 exports.MAPConnectionError = MAPConnectionError;
 exports.MAPErrorDataSchema = MAPErrorDataSchema;
 exports.MAPErrorSchema = MAPErrorSchema;