macro-agent 0.0.10 → 0.0.12

package/dist/map/adapter/mail-handler-adapter.js

@@ -0,0 +1,292 @@
+/**
+ * Mail Protocol Handler Adapter
+ *
+ * Creates a HandlerRegistry for mail/* protocol methods that can be
+ * merged into the MAPAdapter's RPC handler. Delegates to MailService
+ * for business logic.
+ *
+ * Implements the following MAP mail protocol methods:
+ * - mail/create — Create a conversation
+ * - mail/get — Get conversation details
+ * - mail/list — List conversations
+ * - mail/close — Close a conversation
+ * - mail/join — Join a conversation
+ * - mail/leave — Leave a conversation
+ * - mail/turn — Record a turn
+ * - mail/turns/list — List turns
+ * - mail/thread/create — Create a thread
+ * - mail/thread/list — List threads
+ * - mail/replay — Replay turns
+ */
+import { nanoid } from "nanoid";
+import { RPCError } from "./rpc-handler.js";
+/**
+ * Create mail protocol handlers backed by a MailService.
+ */
+export function createMailHandlers(mailService) {
+    /**
+     * Validate that a conversation exists, returning it or throwing RPCError.
+     */
+    function requireConversation(id) {
+        const conv = mailService.getConversation(id);
+        if (!conv)
+            throw RPCError.notFound("conversation", id);
+        return conv;
+    }
+    return {
+        // =========================================================================
+        // Conversation lifecycle
+        // =========================================================================
+        "mail/create": async (params, ctx) => {
+            const p = params;
+            const { conversationId } = mailService.createConversation({
+                type: p.type ?? "session",
+                subject: p.subject,
+                createdBy: ctx.participantId,
+                parentConversationId: p.parentConversationId,
+                metadata: p.metadata,
+            });
+            // Auto-join creator
+            mailService.joinConversation({
+                conversationId,
+                participantId: ctx.participantId,
+                participantType: "agent",
+                role: "initiator",
+            });
+            // Join initial participants
+            if (p.initialParticipants) {
+                for (const ip of p.initialParticipants) {
+                    mailService.joinConversation({
+                        conversationId,
+                        participantId: ip.id,
+                        participantType: "agent",
+                        role: ip.role ?? "worker",
+                    });
+                }
+            }
+            const conversation = mailService.getConversation(conversationId);
+            return { conversation };
+        },
+        "mail/get": async (params) => {
+            const p = params;
+            const conversation = requireConversation(p.conversationId);
+            const response = { conversation };
+            if (p.include?.participants) {
+                response.participants = mailService.listParticipants(p.conversationId, true);
+            }
+            if (p.include?.recentTurns) {
+                response.recentTurns = mailService.listTurns({
+                    conversationId: p.conversationId,
+                    limit: p.include.recentTurns,
+                    order: "desc",
+                });
+            }
+            if (p.include?.stats) {
+                const totalTurns = mailService.countTurns(p.conversationId);
+                const activeParticipants = mailService.listParticipants(p.conversationId, true);
+                response.stats = {
+                    totalTurns,
+                    activeParticipants: activeParticipants.length,
+                };
+            }
+            return response;
+        },
+        "mail/list": async (params) => {
+            const p = (params ?? {});
+            const limit = p.limit ?? 50;
+            const conversations = mailService.listConversations(p.filter
+                ? {
+                    type: p.filter.type,
+                    status: p.filter.status,
+                    participantId: p.filter.participantId,
+                    parentConversationId: p.filter.parentConversationId,
+                }
+                : undefined);
+            // Cursor-based pagination
+            let startIndex = 0;
+            if (p.cursor) {
+                const idx = conversations.findIndex((c) => c.id === p.cursor);
+                if (idx >= 0)
+                    startIndex = idx + 1;
+            }
+            const page = conversations.slice(startIndex, startIndex + limit + 1);
+            const hasMore = page.length > limit;
+            const items = hasMore ? page.slice(0, limit) : page;
+            return {
+                conversations: items,
+                hasMore,
+                nextCursor: hasMore ? items[items.length - 1].id : undefined,
+            };
+        },
+        "mail/close": async (params, ctx) => {
+            const p = params;
+            const conv = requireConversation(p.conversationId);
+            if (conv.status !== "active") {
+                throw RPCError.invalidParams(`Conversation already ${conv.status}: ${p.conversationId}`);
+            }
+            mailService.closeConversation({
+                conversationId: p.conversationId,
+                closedBy: ctx.participantId,
+                reason: p.reason,
+            });
+            const conversation = mailService.getConversation(p.conversationId);
+            return { conversation };
+        },
+        // =========================================================================
+        // Participants
+        // =========================================================================
+        "mail/join": async (params, ctx) => {
+            const p = params;
+            requireConversation(p.conversationId);
+            // Check for duplicate join — if already an active participant, skip
+            const existing = mailService.listParticipants(p.conversationId, true);
+            const alreadyJoined = existing.some((pt) => pt.id === ctx.participantId);
+            if (!alreadyJoined) {
+                mailService.joinConversation({
+                    conversationId: p.conversationId,
+                    participantId: ctx.participantId,
+                    participantType: "agent",
+                    role: p.role ?? "worker",
+                });
+            }
+            const conversation = mailService.getConversation(p.conversationId);
+            const response = { conversation };
+            if (p.catchUp) {
+                const catchUpLimit = p.catchUp.limit ?? 50;
+                const history = mailService.listTurns({
+                    conversationId: p.conversationId,
+                    limit: catchUpLimit + 1,
+                    order: "asc",
+                });
+                const hasMore = history.length > catchUpLimit;
+                const items = hasMore ? history.slice(0, catchUpLimit) : history;
+                response.history = items;
+                if (hasMore) {
+                    response.historyCursor = items[items.length - 1].id;
+                }
+            }
+            return response;
+        },
+        "mail/leave": async (params, ctx) => {
+            const p = params;
+            requireConversation(p.conversationId);
+            mailService.leaveConversation(p.conversationId, ctx.participantId);
+            return { success: true, leftAt: Date.now() };
+        },
+        // =========================================================================
+        // Turns
+        // =========================================================================
+        "mail/turn": async (params, ctx) => {
+            const p = params;
+            requireConversation(p.conversationId);
+            const { turnId } = mailService.recordTurn({
+                conversationId: p.conversationId,
+                participant: ctx.participantId,
+                contentType: p.contentType,
+                content: p.content,
+                threadId: p.threadId,
+                inReplyTo: p.inReplyTo,
+                sourceType: "explicit",
+                metadata: p.metadata,
+            });
+            const turns = mailService.listTurns({
+                conversationId: p.conversationId,
+                limit: 1,
+                order: "desc",
+            });
+            return { turn: turns[0] ?? { id: turnId } };
+        },
+        "mail/turns/list": async (params) => {
+            const p = params;
+            requireConversation(p.conversationId);
+            const limit = p.limit ?? 50;
+            let turns = mailService.listTurns({
+                conversationId: p.conversationId,
+                threadId: p.filter?.threadId,
+                participantId: p.filter?.participantId,
+                limit: limit + 1,
+                order: p.order,
+            });
+            // Filter by multiple content types (if provided)
+            if (p.filter?.contentTypes?.length) {
+                const typeSet = new Set(p.filter.contentTypes);
+                turns = turns.filter((t) => typeSet.has(t.contentType));
+            }
+            const hasMore = turns.length > limit;
+            const items = hasMore ? turns.slice(0, limit) : turns;
+            return {
+                turns: items,
+                hasMore,
+                nextCursor: hasMore ? items[items.length - 1].id : undefined,
+            };
+        },
+        // =========================================================================
+        // Threads
+        // =========================================================================
+        "mail/thread/create": async (params, ctx) => {
+            const p = params;
+            requireConversation(p.conversationId);
+            const threadId = `thread_${nanoid(12)}`;
+            mailService.stores.threads.save({
+                id: threadId,
+                conversationId: p.conversationId,
+                rootTurnId: p.rootTurnId,
+                subject: p.subject,
+                parentThreadId: p.parentThreadId,
+                turnCount: 0,
+                participantCount: 0,
+                createdAt: Date.now(),
+                updatedAt: Date.now(),
+                createdBy: ctx.participantId,
+            });
+            const thread = mailService.stores.threads.get(threadId);
+            return { thread };
+        },
+        "mail/thread/list": async (params) => {
+            const p = (params ?? {});
+            requireConversation(p.conversationId);
+            const threads = mailService.stores.threads.list({
+                conversationId: p.conversationId,
+                parentThreadId: p.parentThreadId,
+            });
+            const limit = p.limit ?? 50;
+            let startIndex = 0;
+            if (p.cursor) {
+                const idx = threads.findIndex((t) => t.id === p.cursor);
+                if (idx >= 0)
+                    startIndex = idx + 1;
+            }
+            const page = threads.slice(startIndex, startIndex + limit + 1);
+            const hasMore = page.length > limit;
+            const items = hasMore ? page.slice(0, limit) : page;
+            return {
+                threads: items,
+                hasMore,
+                nextCursor: hasMore ? items[items.length - 1].id : undefined,
+            };
+        },
+        // =========================================================================
+        // Replay
+        // =========================================================================
+        "mail/replay": async (params) => {
+            const p = params;
+            requireConversation(p.conversationId);
+            const limit = p.limit ?? 50;
+            const turns = mailService.listTurns({
+                conversationId: p.conversationId,
+                threadId: p.threadId,
+                limit: limit + 1,
+                order: "asc",
+            });
+            const hasMore = turns.length > limit;
+            const items = hasMore ? turns.slice(0, limit) : turns;
+            return {
+                turns: items,
+                hasMore,
+                nextCursor: hasMore ? items[items.length - 1].id : undefined,
+                missedCount: 0,
+            };
+        },
+    };
+}
+//# sourceMappingURL=mail-handler-adapter.js.map

package/dist/map/adapter/mail-handler-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-handler-adapter.js","sourceRoot":"","sources":["../../../src/map/adapter/mail-handler-adapter.ts"],"names":[],"mappings":"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"}

package/dist/map/adapter/map-adapter.d.ts

@@ -1,17 +1,33 @@
 /**
- * MAPAdapter - Core MAP Protocol Adapter Implementation
+ * MAPAdapter - External MAP Protocol Interface
  *
- * The MAPAdapter is the external-facing component that:
- * - Accepts MAP protocol connections from clients, agents, and gateways
- * - Manages participant lifecycle and authentication
- * - Handles subscriptions and event streaming
- * - Dispatches extension method calls
- * - Enforces system-level permissions (Layer 1)
+ * ## Routing Architecture Role
  *
- * The adapter delegates to internal components:
- * - MessageRouter: For message routing and delivery
+ * MAPAdapter is the **external protocol translation layer** for MAP clients.
+ * It translates MAP protocol messages into internal routing calls.
+ *
+ * ```
+ * External → MAPAdapter → MessageRouter → EventStore
+ * (MAP RPC)   (this)      (routing)       (persistence)
+ * ```
+ *
+ * **Responsibilities:**
+ * - Accept MAP protocol connections (JSON-RPC over WebSocket/streams)
+ * - Manage participant lifecycle (connect, disconnect, capabilities)
+ * - Handle authentication and permission enforcement (Layer 1)
+ * - Translate MAP addresses to internal routing
+ * - Stream events to subscribed participants
+ * - Dispatch extension method calls (spawn, wake, tasks, etc.)
+ *
+ * **Delegates to internal components:**
+ * - MessageRouter: For message routing and delivery (sendToAddress)
  * - AgentManager: For agent lifecycle operations
- * - EventStore: For event persistence and replay
+ * - EventStore: For event persistence and subscription
+ *
+ * **Not responsible for:**
+ * - Internal agent-to-agent messaging (use MessageRouter directly)
+ * - Batch event delivery (use TriggerRouter/WakeManager)
+ * - Legacy channel-based routing (use MessageRouter.send())
  *
  * @see specs/s-5qir_map_integration_for_macro_agent.md
  */
@@ -66,6 +82,10 @@ export interface MAPAdapterServices {
      * Default working directory for ACP sessions.
      */
     defaultCwd?: string;
+    /**
+     * Mail service for conversation tracking.
+     */
+    mailService?: import("../../mail/mail-service.js").MailService;
 }
 /**
  * Internal agent state from AgentManager.
@@ -140,6 +160,10 @@ export declare class MAPAdapterImpl implements MAPAdapter {
     private sendToSession;
     private emitAdapterEvent;
     private handleConnect;
+    /**
+     * Get default capabilities for a participant type.
+     */
+    private getDefaultCapabilities;
     private handleDisconnect;
     private handleSubscribe;
     private handleUnsubscribe;

package/dist/map/adapter/map-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-adapter.d.ts","sourceRoot":"","sources":["../../../src/map/adapter/map-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"map-adapter.d.ts","sourceRoot":"","sources":["../../../src/map/adapter/map-adapter.ts"],"names":[],"mappings":"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"}

package/dist/map/adapter/map-adapter.js

@@ -1,27 +1,44 @@
 /**
- * MAPAdapter - Core MAP Protocol Adapter Implementation
+ * MAPAdapter - External MAP Protocol Interface
  *
- * The MAPAdapter is the external-facing component that:
- * - Accepts MAP protocol connections from clients, agents, and gateways
- * - Manages participant lifecycle and authentication
- * - Handles subscriptions and event streaming
- * - Dispatches extension method calls
- * - Enforces system-level permissions (Layer 1)
+ * ## Routing Architecture Role
  *
- * The adapter delegates to internal components:
- * - MessageRouter: For message routing and delivery
+ * MAPAdapter is the **external protocol translation layer** for MAP clients.
+ * It translates MAP protocol messages into internal routing calls.
+ *
+ * ```
+ * External → MAPAdapter → MessageRouter → EventStore
+ * (MAP RPC)   (this)      (routing)       (persistence)
+ * ```
+ *
+ * **Responsibilities:**
+ * - Accept MAP protocol connections (JSON-RPC over WebSocket/streams)
+ * - Manage participant lifecycle (connect, disconnect, capabilities)
+ * - Handle authentication and permission enforcement (Layer 1)
+ * - Translate MAP addresses to internal routing
+ * - Stream events to subscribed participants
+ * - Dispatch extension method calls (spawn, wake, tasks, etc.)
+ *
+ * **Delegates to internal components:**
+ * - MessageRouter: For message routing and delivery (sendToAddress)
  * - AgentManager: For agent lifecycle operations
- * - EventStore: For event persistence and replay
+ * - EventStore: For event persistence and subscription
+ *
+ * **Not responsible for:**
+ * - Internal agent-to-agent messaging (use MessageRouter directly)
+ * - Batch event delivery (use TriggerRouter/WakeManager)
+ * - Legacy channel-based routing (use MessageRouter.send())
  *
  * @see specs/s-5qir_map_integration_for_macro_agent.md
  */
 import { ulid } from "ulid";
-import { isAgentAddress } from "../types.js";
+import { isAgentAddress, } from "../types.js";
 import { createConnectionManager, } from "./connection-manager.js";
 import { createSubscriptionManager, } from "./subscription-manager.js";
 import { createRPCHandler, RPCError, createCapabilityMiddleware, createNotification, } from "./rpc-handler.js";
 import { EXTENSION_CAPABILITIES } from "./extensions/index.js";
 import { ACPOverMAPHandler } from "./acp-over-map.js";
+import { createMailHandlers } from "./mail-handler-adapter.js";
 // =============================================================================
 // MAPAdapter Implementation
 // =============================================================================
@@ -291,6 +308,7 @@ export class MAPAdapterImpl {
                     eventId: event.eventId, // For deduplication
                     timestamp: event.timestamp, // Envelope timestamp
                     event: {
+                        // The actual event object
                         id: event.eventId,
                         type: event.type,
                         timestamp: event.timestamp,
@@ -436,6 +454,13 @@ export class MAPAdapterImpl {
                 return handler(extCtx, params);
             };
         }
+        // Add mail protocol handlers if mail service is available
+        if (this.services.mailService) {
+            const mailHandlers = createMailHandlers(this.services.mailService);
+            for (const [method, handler] of Object.entries(mailHandlers)) {
+                handlers[method] = handler;
+            }
+        }
         // Capability requirements for methods
         const capabilityRequirements = {
             "map/subscribe": "canSubscribe",
@@ -525,13 +550,81 @@ export class MAPAdapterImpl {
         if (!participant) {
             throw RPCError.notFound("participant", participantId);
         }
-        // TODO: Handle authentication when auth hook is provided
-        // For now, return the already-assigned capabilities
+        // Parse connect request parameters
+        const connectParams = params;
+        const requestedType = connectParams?.type ?? participant.type;
+        const credentials = connectParams?.credentials;
+        // Handle authentication if handler is configured and credentials provided
+        if (this.config.authenticate && credentials) {
+            const authResult = await this.config.authenticate(requestedType, credentials);
+            if (!authResult.allowed) {
+                throw RPCError.authenticationFailed(authResult.error ?? "Authentication failed");
+            }
+            // Update capabilities based on auth result
+            const newCapabilities = authResult.capabilities ?? this.getDefaultCapabilities(requestedType);
+            this.connections.updateCapabilities(participantId, newCapabilities);
+            // Return updated participant info
+            const updatedParticipant = this.connections.getParticipant(participantId);
+            return {
+                participantId: participant.id,
+                capabilities: updatedParticipant?.capabilities ?? newCapabilities,
+            };
+        }
+        // No auth handler or no credentials - use default capabilities for the type
+        if (requestedType !== participant.type) {
+            const defaultCapabilities = this.getDefaultCapabilities(requestedType);
+            this.connections.updateCapabilities(participantId, defaultCapabilities);
+            const updatedParticipant = this.connections.getParticipant(participantId);
+            return {
+                participantId: participant.id,
+                capabilities: updatedParticipant?.capabilities ?? defaultCapabilities,
+            };
+        }
         return {
             participantId: participant.id,
             capabilities: participant.capabilities,
         };
     }
+    /**
+     * Get default capabilities for a participant type.
+     */
+    getDefaultCapabilities(type) {
+        switch (type) {
+            case "agent":
+                return (this.config.defaultAgentCapabilities ?? {
+                    canQuery: true,
+                    canSubscribe: true,
+                    canMessage: true,
+                    canSpawn: true,
+                    canStop: true,
+                    canManageScopes: true,
+                    canManageTasks: true,
+                    canManageFederation: true,
+                });
+            case "gateway":
+                return {
+                    canQuery: true,
+                    canSubscribe: true,
+                    canMessage: true,
+                    canSpawn: false,
+                    canStop: false,
+                    canManageScopes: false,
+                    canManageTasks: false,
+                    canManageFederation: true,
+                };
+            case "client":
+            default:
+                return (this.config.defaultClientCapabilities ?? {
+                    canQuery: true,
+                    canSubscribe: true,
+                    canMessage: true,
+                    canSpawn: false,
+                    canStop: false,
+                    canManageScopes: false,
+                    canManageTasks: false,
+                });
+        }
+    }
     async handleDisconnect(participantId) {
         await this.disconnectParticipant(participantId, "client_disconnect");
         return { success: true };
@@ -573,7 +666,10 @@ export class MAPAdapterImpl {
         // Check if this is an ACP-over-MAP message
         // SDK sends ACP envelope directly as payload (not wrapped in content)
         const rawPayload = payload;
-        if (rawPayload && typeof rawPayload === 'object' && 'acp' in rawPayload && 'acpContext' in rawPayload) {
+        if (rawPayload &&
+            typeof rawPayload === "object" &&
+            "acp" in rawPayload &&
+            "acpContext" in rawPayload) {
             // This is an ACP envelope - route through ACP-over-MAP handler
             return this.handleACPOverMAP(participantId, to, rawPayload, ctx);
         }