@multi-agent-protocol/sdk 0.0.7 → 0.0.8

package/dist/testing.d.cts

@@ -1,4 +1,4 @@
-import { P as ParticipantCapabilities, fE as SystemExposure, d as FederationRoutingConfig, S as Stream, cw as BaseConnection, f as SessionId, A as AgentId, m as Agent, l as ScopeId, n as Scope, c as Message, q as Event, j as ParticipantId, L as SubscriptionId, cD as ClientConnectionOptions, cC as ClientConnection, c1 as AgentsListRequestParams, eq as ScopesListRequestParams, p as SubscriptionFilter, eQ as Subscription, e as EventType, bL as AgentConnectionOptions, W as AgentConnection } from './index-BQXp4_rd.cjs';
+import { P as ParticipantCapabilities, gF as SystemExposure, d as FederationRoutingConfig, S as Stream, cw as BaseConnection, f as SessionId, A as AgentId, m as Agent, l as ScopeId, n as Scope, c as Message, q as Event, j as ParticipantId, L as SubscriptionId, cD as ClientConnectionOptions, cC as ClientConnection, c1 as AgentsListRequestParams, fk as ScopesListRequestParams, p as SubscriptionFilter, fK as Subscription, e as EventType, bL as AgentConnectionOptions, W as AgentConnection } from './index-BVvyY2kb.cjs';
 import 'events';
 
 /**

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { P as ParticipantCapabilities, fE as SystemExposure, d as FederationRoutingConfig, S as Stream, cw as BaseConnection, f as SessionId, A as AgentId, m as Agent, l as ScopeId, n as Scope, c as Message, q as Event, j as ParticipantId, L as SubscriptionId, cD as ClientConnectionOptions, cC as ClientConnection, c1 as AgentsListRequestParams, eq as ScopesListRequestParams, p as SubscriptionFilter, eQ as Subscription, e as EventType, bL as AgentConnectionOptions, W as AgentConnection } from './index-BQXp4_rd.js';
+import { P as ParticipantCapabilities, gF as SystemExposure, d as FederationRoutingConfig, S as Stream, cw as BaseConnection, f as SessionId, A as AgentId, m as Agent, l as ScopeId, n as Scope, c as Message, q as Event, j as ParticipantId, L as SubscriptionId, cD as ClientConnectionOptions, cC as ClientConnection, c1 as AgentsListRequestParams, fk as ScopesListRequestParams, p as SubscriptionFilter, fK as Subscription, e as EventType, bL as AgentConnectionOptions, W as AgentConnection } from './index-BVvyY2kb.js';
 import 'events';
 
 /**

package/dist/testing.js

@@ -200,6 +200,21 @@ var PERMISSION_METHODS = {
 var FEDERATION_METHODS = {
   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",
@@ -250,13 +265,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;
 
@@ -3972,6 +4001,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
   // ===========================================================================
   /**
@@ -4933,6 +5143,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
   // ===========================================================================
   /**