macro-agent 0.2.5 → 0.2.6

package/dist/mail/stores/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * MAP-compatible store interfaces for mail.
+ *
+ * These mirror the store interfaces from the MAP SDK server module
+ * (ConversationStore, TurnStore, ThreadStore, ParticipantStore) so that
+ * our EventStore-backed implementations can be plugged into MAP handlers.
+ *
+ * The MAP SDK server module is not exported from the installed package,
+ * so we define the interfaces locally. They match the SDK's shapes so
+ * swapping to SDK imports is a single-line change per type.
+ */
+export interface ServerConversation {
+    id: string;
+    type: string;
+    status: string;
+    subject?: string;
+    participantCount: number;
+    parentConversationId?: string;
+    parentTurnId?: string;
+    createdAt: number;
+    updatedAt: number;
+    closedAt?: number;
+    createdBy: string;
+    metadata: Record<string, unknown>;
+}
+export interface ServerParticipant {
+    id: string;
+    conversationId: string;
+    type: "user" | "agent" | "system";
+    role: string;
+    joinedAt: number;
+    leftAt?: number;
+    permissions: {
+        canSend: boolean;
+        canObserve: boolean;
+        canInvite: boolean;
+        canRemove: boolean;
+        canCreateThreads: boolean;
+        historyAccess: "none" | "from-join" | "full";
+        canSeeInternal: boolean;
+    };
+    agentInfo?: {
+        agentId: string;
+        name?: string;
+        role?: string;
+    };
+}
+export interface ServerTurn {
+    id: string;
+    conversationId: string;
+    participant: string;
+    timestamp: number;
+    contentType: string;
+    content: unknown;
+    threadId?: string;
+    inReplyTo?: string;
+    source: {
+        type: "explicit";
+        method: "mail/turn";
+    } | {
+        type: "intercepted";
+        messageId: string;
+    };
+    visibility?: {
+        type: string;
+        [key: string]: unknown;
+    };
+    status?: string;
+    metadata: Record<string, unknown>;
+}
+export interface ServerThread {
+    id: string;
+    conversationId: string;
+    parentThreadId?: string;
+    subject?: string;
+    rootTurnId: string;
+    turnCount: number;
+    participantCount: number;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: string;
+}
+export interface MAPConversationFilter {
+    type?: string[];
+    status?: string[];
+    participantId?: string;
+    createdAfter?: number;
+    createdBefore?: number;
+    parentConversationId?: string;
+}
+export interface MAPTurnFilter {
+    conversationId: string;
+    threadId?: string;
+    contentTypes?: string[];
+    participantId?: string;
+    afterTurnId?: string;
+    beforeTurnId?: string;
+    afterTimestamp?: number;
+    beforeTimestamp?: number;
+    limit?: number;
+    order?: "asc" | "desc";
+}
+export interface MAPThreadFilter {
+    conversationId: string;
+    parentThreadId?: string;
+}
+export interface MAPParticipantFilter {
+    conversationId?: string;
+    participantId?: string;
+    role?: string;
+    active?: boolean;
+}
+export interface ConversationStore {
+    save(conversation: ServerConversation): void;
+    get(id: string): ServerConversation | undefined;
+    list(filter?: MAPConversationFilter): ServerConversation[];
+    delete(id: string): boolean;
+    clear(): void;
+}
+export interface TurnStore {
+    append(turn: ServerTurn): void;
+    get(id: string): ServerTurn | undefined;
+    list(filter: MAPTurnFilter): ServerTurn[];
+    delete(id: string): boolean;
+    deleteByConversation(conversationId: string): number;
+    count(conversationId: string, threadId?: string): number;
+    clear(): void;
+}
+export interface ThreadStore {
+    save(thread: ServerThread): void;
+    get(id: string): ServerThread | undefined;
+    list(filter: MAPThreadFilter): ServerThread[];
+    delete(id: string): boolean;
+    deleteByConversation(conversationId: string): number;
+    clear(): void;
+}
+export interface ParticipantStore {
+    save(participant: ServerParticipant): void;
+    get(conversationId: string, participantId: string): ServerParticipant | undefined;
+    list(filter: MAPParticipantFilter): ServerParticipant[];
+    delete(conversationId: string, participantId: string): boolean;
+    deleteByConversation(conversationId: string): number;
+    getConversationsForParticipant(participantId: string, active?: boolean): string[];
+    clear(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mail/stores/types.d.ts.map

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

package/dist/mail/stores/types.js

@@ -0,0 +1,13 @@
+/**
+ * MAP-compatible store interfaces for mail.
+ *
+ * These mirror the store interfaces from the MAP SDK server module
+ * (ConversationStore, TurnStore, ThreadStore, ParticipantStore) so that
+ * our EventStore-backed implementations can be plugged into MAP handlers.
+ *
+ * The MAP SDK server module is not exported from the installed package,
+ * so we define the interfaces locally. They match the SDK's shapes so
+ * swapping to SDK imports is a single-line change per type.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mail/stores/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mail/stores/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/mail/turn-recorder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TurnRecorder — Hierarchy-aware conversation resolution and turn recording.
+ *
+ * Resolves which conversation a message belongs to based on the
+ * relationship between sender and receiver:
+ * - Parent→child or child→parent: child's task conversation
+ * - Peers (no parent/child relationship): auto-created peer conversation
+ *
+ * @module mail/turn-recorder
+ */
+import type { EventStore } from "../store/event-store.js";
+import type { MailService } from "./mail-service.js";
+import type { ConversationMap } from "./conversation-map.js";
+import type { TurnRecorderCallback } from "../router/types.js";
+export interface TurnRecorderDeps {
+    mailService: MailService;
+    conversationMap: ConversationMap;
+    eventStore: EventStore;
+}
+/**
+ * Create a TurnRecorderCallback for use with MessageRouter.setTurnRecorder().
+ *
+ * Resolution algorithm:
+ * 1. Get both agents from EventStore
+ * 2. If parent→child or child→parent: use child's task conversation
+ * 3. If peers: getOrCreatePeerConversation()
+ * 4. Record turn with sourceType: 'intercepted'
+ */
+export declare function createTurnRecorder(deps: TurnRecorderDeps): TurnRecorderCallback;
+//# sourceMappingURL=turn-recorder.d.ts.map

package/dist/mail/turn-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-recorder.d.ts","sourceRoot":"","sources":["../../src/mail/turn-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,CA2F/E"}

package/dist/mail/turn-recorder.js

@@ -0,0 +1,98 @@
+/**
+ * TurnRecorder — Hierarchy-aware conversation resolution and turn recording.
+ *
+ * Resolves which conversation a message belongs to based on the
+ * relationship between sender and receiver:
+ * - Parent→child or child→parent: child's task conversation
+ * - Peers (no parent/child relationship): auto-created peer conversation
+ *
+ * @module mail/turn-recorder
+ */
+/**
+ * Create a TurnRecorderCallback for use with MessageRouter.setTurnRecorder().
+ *
+ * Resolution algorithm:
+ * 1. Get both agents from EventStore
+ * 2. If parent→child or child→parent: use child's task conversation
+ * 3. If peers: getOrCreatePeerConversation()
+ * 4. Record turn with sourceType: 'intercepted'
+ */
+export function createTurnRecorder(deps) {
+    const { mailService, conversationMap, eventStore } = deps;
+    return (info) => {
+        const { from, toAgent, content, messageId } = info;
+        // Resolve conversation based on agent relationship
+        const conversationId = resolveConversation(from, toAgent);
+        if (!conversationId)
+            return;
+        // Record the turn — never fail core message routing
+        try {
+            mailService.recordTurn({
+                conversationId,
+                participant: from,
+                contentType: "text",
+                content,
+                sourceType: "intercepted",
+                sourceMessageId: messageId,
+            });
+        }
+        catch (err) {
+            console.warn(`[TurnRecorder] Failed to record turn: ${err}`);
+        }
+    };
+    /**
+     * Find the nearest common ancestor of two agents and return its conversation ID.
+     * Lineage arrays are ordered root-to-parent: [grandparent, parent].
+     */
+    function findNearestCommonAncestorConversation(lineageA, lineageB) {
+        // Walk lineages from the end (nearest ancestor) to find the deepest shared ancestor
+        const setB = new Set(lineageB);
+        for (let i = lineageA.length - 1; i >= 0; i--) {
+            if (setB.has(lineageA[i])) {
+                // Found nearest common ancestor — look up its conversation
+                return (conversationMap.getAgentConversation(lineageA[i]) ??
+                    conversationMap.getSessionConversation(lineageA[i]));
+            }
+        }
+        return undefined;
+    }
+    function resolveConversation(from, to) {
+        const fromAgent = eventStore.getAgent(from);
+        const toAgent = eventStore.getAgent(to);
+        // If either agent doesn't exist, skip
+        if (!fromAgent || !toAgent)
+            return null;
+        // Check parent→child relationship
+        if (fromAgent.parent === to) {
+            // from is a child of to — use from's task conversation
+            return conversationMap.getAgentConversation(from) ?? null;
+        }
+        if (toAgent.parent === from) {
+            // to is a child of from — use to's task conversation
+            return conversationMap.getAgentConversation(to) ?? null;
+        }
+        // Peers — get or create peer conversation
+        return conversationMap.getOrCreatePeerConversation(from, to, () => {
+            // Find nearest common ancestor's conversation for tree structure
+            const parentConversationId = findNearestCommonAncestorConversation(fromAgent.lineage, toAgent.lineage);
+            const { conversationId } = mailService.createConversation({
+                type: "peer",
+                subject: `Peer: ${from} ↔ ${to}`,
+                createdBy: from,
+                parentConversationId,
+            });
+            mailService.joinConversation({
+                conversationId,
+                participantId: from,
+                role: "worker",
+            });
+            mailService.joinConversation({
+                conversationId,
+                participantId: to,
+                role: "worker",
+            });
+            return conversationId;
+        });
+    }
+}
+//# sourceMappingURL=turn-recorder.js.map

package/dist/mail/turn-recorder.js.map

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

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

@@ -0,0 +1,115 @@
+/**
+ * ACP-over-MAP Handler
+ *
+ * Handles ACP protocol messages that arrive via MAP instead of direct WebSocket.
+ * Provides a bridge between MAP messaging and the MacroAgent ACP implementation.
+ *
+ * This allows external clients to communicate with macro-agent agents using
+ * ACP protocol semantics over the MAP transport layer.
+ */
+import type { AgentManager } from "../../agent/agent-manager.js";
+import type { EventStore } from "../../store/event-store.js";
+import type { TaskManager } from "../../task/task-manager.js";
+import type { AgentId } from "../../store/types/index.js";
+export interface ACPEnvelope {
+    acp: {
+        jsonrpc: string;
+        id?: string | number;
+        method?: string;
+        params?: unknown;
+        result?: unknown;
+        error?: {
+            code: number;
+            message: string;
+            data?: unknown;
+        };
+    };
+    acpContext: {
+        streamId: string;
+        sessionId?: string;
+        direction: string;
+    };
+}
+export interface ACPOverMAPConfig {
+    agentManager: AgentManager;
+    eventStore: EventStore;
+    taskManager: TaskManager;
+    defaultCwd?: string;
+    /**
+     * Callback when a new agent is created via session/new or session/loadSession.
+     * Used by MAPAdapter to emit agent.registered events to all subscribers.
+     */
+    onAgentRegistered?: (agent: {
+        id: string;
+        name?: string;
+        role?: string;
+        parent?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}
+/**
+ * Callback for emitting ACP notifications during request processing.
+ * Used to stream session updates back to the client.
+ */
+export type ACPNotificationEmitter = (notification: ACPEnvelope) => void;
+export declare class ACPOverMAPHandler {
+    private agentManager;
+    private eventStore;
+    private taskManager;
+    private defaultCwd;
+    private onAgentRegistered?;
+    /** Stream states by streamId */
+    private streams;
+    /** Session mapper for ACP session -> Agent mapping */
+    private sessionMapper;
+    constructor(config: ACPOverMAPConfig);
+    /**
+     * Notify subscribers that a new agent was registered.
+     * Looks up agent details from EventStore and calls the onAgentRegistered callback.
+     */
+    private notifyAgentRegistered;
+    /**
+     * Abort all active streams targeting a specific agent.
+     * Called when an agent is stopped via MAP protocol to interrupt
+     * any in-progress ACP prompt streaming.
+     */
+    abortStreamsForAgent(agentId: AgentId): void;
+    /**
+     * Process an ACP request and return the response.
+     * @param targetAgentId - Target agent for the request
+     * @param envelope - ACP request envelope
+     * @param emitNotification - Optional callback to emit notifications (for streaming updates)
+     */
+    processRequest(targetAgentId: AgentId, envelope: ACPEnvelope, emitNotification?: ACPNotificationEmitter): Promise<ACPEnvelope>;
+    private handleInitialize;
+    private handleNewSession;
+    private handleLoadSession;
+    private handleAuthenticate;
+    private handlePrompt;
+    private handleCancel;
+    private handleExtension;
+    /**
+     * Ensure a conversation exists in the EventStore for a given session.
+     * This must be called before recording turns.
+     */
+    private ensureConversation;
+    /**
+     * Record user and assistant turns after a prompt completes.
+     * Mirrors MacroAgent.recordPromptTurns() for the ACP-over-MAP path.
+     */
+    private recordPromptTurns;
+    /**
+     * Emit a session_info_update notification with title and timestamps.
+     * Uses agent task as title and session mapping timestamps.
+     */
+    private emitSessionInfo;
+    /**
+     * Clean up a stream when it's closed.
+     */
+    closeStream(streamId: string): void;
+    /**
+     * Clean up all streams.
+     */
+    closeAll(): void;
+}
+//# sourceMappingURL=acp-over-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acp-over-map.d.ts","sourceRoot":"","sources":["../../../src/map/adapter/acp-over-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,4BAA4B,CAAC;AA8BlE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC3D,CAAC;IACF,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,KAAK,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,YAAY,EAAE,WAAW,KAAK,IAAI,CAAC;AAgBzE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAwC;IAElE,gCAAgC;IAChC,OAAO,CAAC,OAAO,CAAuC;IAEtD,sDAAsD;IACtD,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,EAAE,gBAAgB;IAiBpC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAW5C;;;;;OAKG;IACG,cAAc,CAClB,aAAa,EAAE,OAAO,EACtB,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,OAAO,CAAC,WAAW,CAAC;YAqGT,gBAAgB;YA0ChB,gBAAgB;YAwChB,iBAAiB;YAqIjB,kBAAkB;YAKlB,YAAY;YA2PZ,YAAY;YAkDZ,eAAe;IA6gB7B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA+DzB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQnC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAMjB"}