@multi-agent-protocol/sdk 0.1.4 → 0.1.6

package/dist/{index-B5adJHGI.d.cts → index-iu0EgJzG.d.cts}

@@ -2637,7 +2637,7 @@ interface TrajectoryContentChunkNotification extends MAPNotificationBase<Traject
     params: TrajectoryContentChunkParams;
 }
 /** Standard task status values. Implementations may use `meta` for richer states. */
-type MAPTaskStatus = 'open' | 'in_progress' | 'blocked' | 'completed' | 'failed';
+type MAPTaskStatus = "open" | "in_progress" | "blocked" | "completed" | "failed";
 /**
  * A task in the MAP system.
  *
@@ -2682,7 +2682,7 @@ interface TaskCompletedEventData {
 }
 interface TasksCreateRequestParams {
     /** Task data. If `id` is omitted, the server generates one. */
-    task: Omit<MAPTask, 'id'> & {
+    task: Omit<MAPTask, "id"> & {
         id?: TaskId;
     };
     _meta?: Meta;
@@ -2909,6 +2909,7 @@ declare const TASK_METHODS: {
 declare const NOTIFICATION_METHODS: {
     readonly EVENT: "map/event";
     readonly MESSAGE: "map/message";
+    readonly SEND: "map/send";
     /** Client acknowledges received events (for backpressure) */
     readonly SUBSCRIBE_ACK: "map/subscribe.ack";
     /** Server notifies client that auth is about to expire */
@@ -5516,7 +5517,7 @@ interface AgentReconnectionOptions {
 /**
  * Agent reconnection event types
  */
-type AgentReconnectionEventType = 'disconnected' | 'reconnecting' | 'reconnected' | 'reconnectFailed';
+type AgentReconnectionEventType = "disconnected" | "reconnecting" | "reconnected" | "reconnectFailed";
 /**
  * Handler for reconnection events
  */
@@ -5567,7 +5568,7 @@ interface AgentConnectOptions {
     metadata?: Record<string, unknown>;
     /** Authentication credentials */
     auth?: {
-        method: 'bearer' | 'api-key' | 'mtls' | 'none';
+        method: AuthMethod;
         token?: string;
     };
     /**
@@ -5606,7 +5607,7 @@ interface AgentMeshConnectOptions {
     metadata?: Record<string, unknown>;
     /** Authentication credentials */
     auth?: {
-        method: 'bearer' | 'api-key' | 'mtls' | 'none';
+        method: "bearer" | "api-key" | "mtls" | "none";
         token?: string;
     };
     /**
@@ -5661,6 +5662,27 @@ declare class AgentConnection {
      * ```
      */
     static connect(url: string, options?: AgentConnectOptions): Promise<AgentConnection>;
+    /**
+     * Create an AgentConnection over WebSocket without performing the MAP handshake.
+     *
+     * Use this when you need to control the connection flow — e.g., to handle
+     * server-driven auth negotiation before registration.
+     *
+     * @example
+     * ```typescript
+     * const agent = await AgentConnection.createConnection('ws://localhost:8080', {
+     *   name: 'Worker',
+     *   role: 'processor',
+     * });
+     *
+     * const result = await agent.connectOnly();
+     * if (result.authRequired) {
+     *   await agent.authenticate({ method: result.authRequired.methods[0], token: cred });
+     * }
+     * await agent.register();
+     * ```
+     */
+    static createConnection(url: string, options?: AgentConnectOptions): Promise<AgentConnection>;
     /**
      * Connect and register an agent via agentic-mesh transport.
      *
@@ -5706,13 +5728,52 @@ declare class AgentConnection {
         /** Token to resume a previously disconnected session */
         resumeToken?: string;
         auth?: {
-            method: 'bearer' | 'api-key' | 'mtls' | 'none';
+            method: AuthMethod;
             token?: string;
         };
     }): Promise<{
         connection: ConnectResponseResult;
         agent: Agent;
     }>;
+    /**
+     * Connect to the MAP system without registering an agent.
+     *
+     * Use this when the server may require authentication before registration.
+     * After connecting, check `authRequired` in the response and call
+     * `authenticate()` if needed, then `register()` to complete the handshake.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.connectOnly();
+     *
+     * if (result.authRequired) {
+     *   const method = result.authRequired.methods[0];
+     *   await agent.authenticate({ method, token: myCredential });
+     * }
+     *
+     * await agent.register();
+     * ```
+     */
+    connectOnly(options?: {
+        agentId?: AgentId;
+        resumeToken?: string;
+        auth?: {
+            method: AuthMethod;
+            token?: string;
+        };
+    }): Promise<ConnectResponseResult>;
+    /**
+     * Register as an agent after connecting.
+     *
+     * Call this after `connectOnly()` and optional `authenticate()` to complete
+     * the connection handshake. Uses the options provided during construction
+     * (name, role, scopes, etc.) unless overridden.
+     */
+    register(overrides?: {
+        agentId?: AgentId;
+        name?: string;
+        role?: string;
+    }): Promise<Agent>;
     /**
      * Authenticate with the server after connection.
      *
@@ -5725,26 +5786,21 @@ declare class AgentConnection {
      *
      * @example
      * ```typescript
-     * const agent = new AgentConnection(stream, { name: 'MyAgent' });
-     *
-     * // First connect to get auth requirements
-     * const connectResult = await agent.connectOnly();
+     * const result = await agent.connectOnly();
      *
-     * if (connectResult.authRequired) {
+     * if (result.authRequired) {
      *   const authResult = await agent.authenticate({
-     *     method: 'api-key',
-     *     token: process.env.AGENT_API_KEY,
+     *     method: result.authRequired.methods[0],
+     *     token: myCredential,
      *   });
-     *
      *   if (authResult.success) {
-     *     // Now register the agent
-     *     await agent.register({ name: 'MyAgent', role: 'worker' });
+     *     await agent.register();
      *   }
      * }
      * ```
      */
     authenticate(auth: {
-        method: 'bearer' | 'api-key' | 'mtls' | 'none';
+        method: AuthMethod;
         token?: string;
     }): Promise<AuthenticateResponseResult>;
     /**
@@ -5756,7 +5812,7 @@ declare class AgentConnection {
      * @returns Updated principal information
      */
     refreshAuth(auth: {
-        method: "bearer" | "api-key" | "mtls" | "none";
+        method: AuthMethod;
         token?: string;
     }): Promise<{
         success: boolean;
@@ -5920,7 +5976,7 @@ declare class AgentConnection {
      * @param params - Conversation creation parameters
      * @returns Created conversation and participant info
      */
-    createConversation(params?: Omit<MailCreateRequestParams, '_meta'>): Promise<MailCreateResponseResult>;
+    createConversation(params?: Omit<MailCreateRequestParams, "_meta">): Promise<MailCreateResponseResult>;
     /**
      * Get a conversation by ID with optional includes.
      *
@@ -5928,14 +5984,14 @@ declare class AgentConnection {
      * @param include - Optional fields to include (participants, threads, recentTurns, stats)
      * @returns Conversation details with requested includes
      */
-    getConversation(conversationId: ConversationId, include?: MailGetRequestParams['include']): Promise<MailGetResponseResult>;
+    getConversation(conversationId: ConversationId, include?: MailGetRequestParams["include"]): Promise<MailGetResponseResult>;
     /**
      * List conversations with optional filters.
      *
      * @param params - Optional filter, limit, and cursor parameters
      * @returns Paginated list of conversations
      */
-    listConversations(params?: Omit<MailListRequestParams, '_meta'>): Promise<MailListResponseResult>;
+    listConversations(params?: Omit<MailListRequestParams, "_meta">): Promise<MailListResponseResult>;
     /**
      * Close a conversation.
      *
@@ -5950,7 +6006,7 @@ declare class AgentConnection {
      * @param params - Join parameters including conversationId and optional catch-up config
      * @returns Conversation, participant, and optional history
      */
-    joinConversation(params: Omit<MailJoinRequestParams, '_meta'>): Promise<MailJoinResponseResult>;
+    joinConversation(params: Omit<MailJoinRequestParams, "_meta">): Promise<MailJoinResponseResult>;
     /**
      * Leave a conversation.
      *
@@ -5965,49 +6021,49 @@ declare class AgentConnection {
      * @param params - Invite parameters including conversationId and participant info
      * @returns Invite result
      */
-    inviteToConversation(params: Omit<MailInviteRequestParams, '_meta'>): Promise<MailInviteResponseResult>;
+    inviteToConversation(params: Omit<MailInviteRequestParams, "_meta">): Promise<MailInviteResponseResult>;
     /**
      * Record a turn (message) in a conversation.
      *
      * @param params - Turn parameters including conversationId, contentType, and content
      * @returns The created turn
      */
-    recordTurn(params: Omit<MailTurnRequestParams, '_meta'>): Promise<MailTurnResponseResult>;
+    recordTurn(params: Omit<MailTurnRequestParams, "_meta">): Promise<MailTurnResponseResult>;
     /**
      * List turns in a conversation with optional filters.
      *
      * @param params - List parameters including conversationId and optional filters
      * @returns Paginated list of turns
      */
-    listTurns(params: Omit<MailTurnsListRequestParams, '_meta'>): Promise<MailTurnsListResponseResult>;
+    listTurns(params: Omit<MailTurnsListRequestParams, "_meta">): Promise<MailTurnsListResponseResult>;
     /**
      * Create a thread in a conversation.
      *
      * @param params - Thread creation parameters including conversationId and rootTurnId
      * @returns The created thread
      */
-    createThread(params: Omit<MailThreadCreateRequestParams, '_meta'>): Promise<MailThreadCreateResponseResult>;
+    createThread(params: Omit<MailThreadCreateRequestParams, "_meta">): Promise<MailThreadCreateResponseResult>;
     /**
      * List threads in a conversation.
      *
      * @param params - List parameters including conversationId
      * @returns Paginated list of threads
      */
-    listThreads(params: Omit<MailThreadListRequestParams, '_meta'>): Promise<MailThreadListResponseResult>;
+    listThreads(params: Omit<MailThreadListRequestParams, "_meta">): Promise<MailThreadListResponseResult>;
     /**
      * 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
      */
-    getConversationSummary(params: Omit<MailSummaryRequestParams, '_meta'>): Promise<MailSummaryResponseResult>;
+    getConversationSummary(params: Omit<MailSummaryRequestParams, "_meta">): Promise<MailSummaryResponseResult>;
     /**
      * 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
      */
-    replayConversation(params: Omit<MailReplayRequestParams, '_meta'>): Promise<MailReplayResponseResult>;
+    replayConversation(params: Omit<MailReplayRequestParams, "_meta">): Promise<MailReplayResponseResult>;
     /**
      * Send a message to an agent with mail context attached.
      *
@@ -6042,7 +6098,7 @@ declare class AgentConnection {
      * @param params - Task creation parameters
      * @returns The created task
      */
-    createTask(params: Omit<TasksCreateRequestParams, '_meta'>): Promise<TasksCreateResponseResult>;
+    createTask(params: Omit<TasksCreateRequestParams, "_meta">): Promise<TasksCreateResponseResult>;
     /**
      * Assign a task to an agent.
      *
@@ -6057,14 +6113,14 @@ declare class AgentConnection {
      * @param params - Update parameters including taskId and fields to change
      * @returns The updated task
      */
-    updateTask(params: Omit<TasksUpdateRequestParams, '_meta'>): Promise<TasksUpdateResponseResult>;
+    updateTask(params: Omit<TasksUpdateRequestParams, "_meta">): Promise<TasksUpdateResponseResult>;
     /**
      * List tasks with optional filters.
      *
      * @param params - Optional filter, limit, and cursor parameters
      * @returns Paginated list of tasks
      */
-    listTasks(params?: Omit<TasksListRequestParams, '_meta'>): Promise<TasksListResponseResult>;
+    listTasks(params?: Omit<TasksListRequestParams, "_meta">): Promise<TasksListResponseResult>;
 }
 
 /**

package/dist/{index-B5adJHGI.d.ts → index-iu0EgJzG.d.ts}

@@ -2637,7 +2637,7 @@ interface TrajectoryContentChunkNotification extends MAPNotificationBase<Traject
     params: TrajectoryContentChunkParams;
 }
 /** Standard task status values. Implementations may use `meta` for richer states. */
-type MAPTaskStatus = 'open' | 'in_progress' | 'blocked' | 'completed' | 'failed';
+type MAPTaskStatus = "open" | "in_progress" | "blocked" | "completed" | "failed";
 /**
  * A task in the MAP system.
  *
@@ -2682,7 +2682,7 @@ interface TaskCompletedEventData {
 }
 interface TasksCreateRequestParams {
     /** Task data. If `id` is omitted, the server generates one. */
-    task: Omit<MAPTask, 'id'> & {
+    task: Omit<MAPTask, "id"> & {
         id?: TaskId;
     };
     _meta?: Meta;
@@ -2909,6 +2909,7 @@ declare const TASK_METHODS: {
 declare const NOTIFICATION_METHODS: {
     readonly EVENT: "map/event";
     readonly MESSAGE: "map/message";
+    readonly SEND: "map/send";
     /** Client acknowledges received events (for backpressure) */
     readonly SUBSCRIBE_ACK: "map/subscribe.ack";
     /** Server notifies client that auth is about to expire */
@@ -5516,7 +5517,7 @@ interface AgentReconnectionOptions {
 /**
  * Agent reconnection event types
  */
-type AgentReconnectionEventType = 'disconnected' | 'reconnecting' | 'reconnected' | 'reconnectFailed';
+type AgentReconnectionEventType = "disconnected" | "reconnecting" | "reconnected" | "reconnectFailed";
 /**
  * Handler for reconnection events
  */
@@ -5567,7 +5568,7 @@ interface AgentConnectOptions {
     metadata?: Record<string, unknown>;
     /** Authentication credentials */
     auth?: {
-        method: 'bearer' | 'api-key' | 'mtls' | 'none';
+        method: AuthMethod;
         token?: string;
     };
     /**
@@ -5606,7 +5607,7 @@ interface AgentMeshConnectOptions {
     metadata?: Record<string, unknown>;
     /** Authentication credentials */
     auth?: {
-        method: 'bearer' | 'api-key' | 'mtls' | 'none';
+        method: "bearer" | "api-key" | "mtls" | "none";
         token?: string;
     };
     /**
@@ -5661,6 +5662,27 @@ declare class AgentConnection {
      * ```
      */
     static connect(url: string, options?: AgentConnectOptions): Promise<AgentConnection>;
+    /**
+     * Create an AgentConnection over WebSocket without performing the MAP handshake.
+     *
+     * Use this when you need to control the connection flow — e.g., to handle
+     * server-driven auth negotiation before registration.
+     *
+     * @example
+     * ```typescript
+     * const agent = await AgentConnection.createConnection('ws://localhost:8080', {
+     *   name: 'Worker',
+     *   role: 'processor',
+     * });
+     *
+     * const result = await agent.connectOnly();
+     * if (result.authRequired) {
+     *   await agent.authenticate({ method: result.authRequired.methods[0], token: cred });
+     * }
+     * await agent.register();
+     * ```
+     */
+    static createConnection(url: string, options?: AgentConnectOptions): Promise<AgentConnection>;
     /**
      * Connect and register an agent via agentic-mesh transport.
      *
@@ -5706,13 +5728,52 @@ declare class AgentConnection {
         /** Token to resume a previously disconnected session */
         resumeToken?: string;
         auth?: {
-            method: 'bearer' | 'api-key' | 'mtls' | 'none';
+            method: AuthMethod;
             token?: string;
         };
     }): Promise<{
         connection: ConnectResponseResult;
         agent: Agent;
     }>;
+    /**
+     * Connect to the MAP system without registering an agent.
+     *
+     * Use this when the server may require authentication before registration.
+     * After connecting, check `authRequired` in the response and call
+     * `authenticate()` if needed, then `register()` to complete the handshake.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.connectOnly();
+     *
+     * if (result.authRequired) {
+     *   const method = result.authRequired.methods[0];
+     *   await agent.authenticate({ method, token: myCredential });
+     * }
+     *
+     * await agent.register();
+     * ```
+     */
+    connectOnly(options?: {
+        agentId?: AgentId;
+        resumeToken?: string;
+        auth?: {
+            method: AuthMethod;
+            token?: string;
+        };
+    }): Promise<ConnectResponseResult>;
+    /**
+     * Register as an agent after connecting.
+     *
+     * Call this after `connectOnly()` and optional `authenticate()` to complete
+     * the connection handshake. Uses the options provided during construction
+     * (name, role, scopes, etc.) unless overridden.
+     */
+    register(overrides?: {
+        agentId?: AgentId;
+        name?: string;
+        role?: string;
+    }): Promise<Agent>;
     /**
      * Authenticate with the server after connection.
      *
@@ -5725,26 +5786,21 @@ declare class AgentConnection {
      *
      * @example
      * ```typescript
-     * const agent = new AgentConnection(stream, { name: 'MyAgent' });
-     *
-     * // First connect to get auth requirements
-     * const connectResult = await agent.connectOnly();
+     * const result = await agent.connectOnly();
      *
-     * if (connectResult.authRequired) {
+     * if (result.authRequired) {
      *   const authResult = await agent.authenticate({
-     *     method: 'api-key',
-     *     token: process.env.AGENT_API_KEY,
+     *     method: result.authRequired.methods[0],
+     *     token: myCredential,
      *   });
-     *
      *   if (authResult.success) {
-     *     // Now register the agent
-     *     await agent.register({ name: 'MyAgent', role: 'worker' });
+     *     await agent.register();
      *   }
      * }
      * ```
      */
     authenticate(auth: {
-        method: 'bearer' | 'api-key' | 'mtls' | 'none';
+        method: AuthMethod;
         token?: string;
     }): Promise<AuthenticateResponseResult>;
     /**
@@ -5756,7 +5812,7 @@ declare class AgentConnection {
      * @returns Updated principal information
      */
     refreshAuth(auth: {
-        method: "bearer" | "api-key" | "mtls" | "none";
+        method: AuthMethod;
         token?: string;
     }): Promise<{
         success: boolean;
@@ -5920,7 +5976,7 @@ declare class AgentConnection {
      * @param params - Conversation creation parameters
      * @returns Created conversation and participant info
      */
-    createConversation(params?: Omit<MailCreateRequestParams, '_meta'>): Promise<MailCreateResponseResult>;
+    createConversation(params?: Omit<MailCreateRequestParams, "_meta">): Promise<MailCreateResponseResult>;
     /**
      * Get a conversation by ID with optional includes.
      *
@@ -5928,14 +5984,14 @@ declare class AgentConnection {
      * @param include - Optional fields to include (participants, threads, recentTurns, stats)
      * @returns Conversation details with requested includes
      */
-    getConversation(conversationId: ConversationId, include?: MailGetRequestParams['include']): Promise<MailGetResponseResult>;
+    getConversation(conversationId: ConversationId, include?: MailGetRequestParams["include"]): Promise<MailGetResponseResult>;
     /**
      * List conversations with optional filters.
      *
      * @param params - Optional filter, limit, and cursor parameters
      * @returns Paginated list of conversations
      */
-    listConversations(params?: Omit<MailListRequestParams, '_meta'>): Promise<MailListResponseResult>;
+    listConversations(params?: Omit<MailListRequestParams, "_meta">): Promise<MailListResponseResult>;
     /**
      * Close a conversation.
      *
@@ -5950,7 +6006,7 @@ declare class AgentConnection {
      * @param params - Join parameters including conversationId and optional catch-up config
      * @returns Conversation, participant, and optional history
      */
-    joinConversation(params: Omit<MailJoinRequestParams, '_meta'>): Promise<MailJoinResponseResult>;
+    joinConversation(params: Omit<MailJoinRequestParams, "_meta">): Promise<MailJoinResponseResult>;
     /**
      * Leave a conversation.
      *
@@ -5965,49 +6021,49 @@ declare class AgentConnection {
      * @param params - Invite parameters including conversationId and participant info
      * @returns Invite result
      */
-    inviteToConversation(params: Omit<MailInviteRequestParams, '_meta'>): Promise<MailInviteResponseResult>;
+    inviteToConversation(params: Omit<MailInviteRequestParams, "_meta">): Promise<MailInviteResponseResult>;
     /**
      * Record a turn (message) in a conversation.
      *
      * @param params - Turn parameters including conversationId, contentType, and content
      * @returns The created turn
      */
-    recordTurn(params: Omit<MailTurnRequestParams, '_meta'>): Promise<MailTurnResponseResult>;
+    recordTurn(params: Omit<MailTurnRequestParams, "_meta">): Promise<MailTurnResponseResult>;
     /**
      * List turns in a conversation with optional filters.
      *
      * @param params - List parameters including conversationId and optional filters
      * @returns Paginated list of turns
      */
-    listTurns(params: Omit<MailTurnsListRequestParams, '_meta'>): Promise<MailTurnsListResponseResult>;
+    listTurns(params: Omit<MailTurnsListRequestParams, "_meta">): Promise<MailTurnsListResponseResult>;
     /**
      * Create a thread in a conversation.
      *
      * @param params - Thread creation parameters including conversationId and rootTurnId
      * @returns The created thread
      */
-    createThread(params: Omit<MailThreadCreateRequestParams, '_meta'>): Promise<MailThreadCreateResponseResult>;
+    createThread(params: Omit<MailThreadCreateRequestParams, "_meta">): Promise<MailThreadCreateResponseResult>;
     /**
      * List threads in a conversation.
      *
      * @param params - List parameters including conversationId
      * @returns Paginated list of threads
      */
-    listThreads(params: Omit<MailThreadListRequestParams, '_meta'>): Promise<MailThreadListResponseResult>;
+    listThreads(params: Omit<MailThreadListRequestParams, "_meta">): Promise<MailThreadListResponseResult>;
     /**
      * 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
      */
-    getConversationSummary(params: Omit<MailSummaryRequestParams, '_meta'>): Promise<MailSummaryResponseResult>;
+    getConversationSummary(params: Omit<MailSummaryRequestParams, "_meta">): Promise<MailSummaryResponseResult>;
     /**
      * 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
      */
-    replayConversation(params: Omit<MailReplayRequestParams, '_meta'>): Promise<MailReplayResponseResult>;
+    replayConversation(params: Omit<MailReplayRequestParams, "_meta">): Promise<MailReplayResponseResult>;
     /**
      * Send a message to an agent with mail context attached.
      *
@@ -6042,7 +6098,7 @@ declare class AgentConnection {
      * @param params - Task creation parameters
      * @returns The created task
      */
-    createTask(params: Omit<TasksCreateRequestParams, '_meta'>): Promise<TasksCreateResponseResult>;
+    createTask(params: Omit<TasksCreateRequestParams, "_meta">): Promise<TasksCreateResponseResult>;
     /**
      * Assign a task to an agent.
      *
@@ -6057,14 +6113,14 @@ declare class AgentConnection {
      * @param params - Update parameters including taskId and fields to change
      * @returns The updated task
      */
-    updateTask(params: Omit<TasksUpdateRequestParams, '_meta'>): Promise<TasksUpdateResponseResult>;
+    updateTask(params: Omit<TasksUpdateRequestParams, "_meta">): Promise<TasksUpdateResponseResult>;
     /**
      * List tasks with optional filters.
      *
      * @param params - Optional filter, limit, and cursor parameters
      * @returns Paginated list of tasks
      */
-    listTasks(params?: Omit<TasksListRequestParams, '_meta'>): Promise<TasksListResponseResult>;
+    listTasks(params?: Omit<TasksListRequestParams, "_meta">): Promise<TasksListResponseResult>;
 }
 
 /**