macro-agent 0.2.4 → 0.2.6

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

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

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

@@ -0,0 +1,85 @@
+/**
+ * Event Translator - Translates internal EventStore events to MAP events
+ *
+ * Converts internal macro-agent events (spawn, terminate, status, message, task)
+ * to MAP protocol event format (EventNotification).
+ *
+ * Translation happens at the adapter boundary, keeping internal events unchanged.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { Event } from "../../store/types/events.js";
+import type { EventNotification } from "./types.js";
+/**
+ * Result of translating an internal event.
+ * Some internal events map to multiple MAP events.
+ */
+export type TranslationResult = {
+    translated: true;
+    events: EventNotification[];
+} | {
+    translated: false;
+    reason: string;
+};
+/**
+ * Context for event translation.
+ */
+export interface TranslationContext {
+    /**
+     * Generate unique event ID.
+     * Defaults to ULID generation.
+     */
+    generateEventId?: () => string;
+}
+/**
+ * Translate an internal EventStore event to MAP EventNotification(s).
+ *
+ * Some internal events (like message) produce multiple MAP events.
+ *
+ * @param event - Internal event from EventStore
+ * @param context - Optional translation context
+ * @returns Translation result with MAP events or reason for not translating
+ */
+export declare function translateEvent(event: Event, context?: TranslationContext): TranslationResult;
+/**
+ * Translate multiple events, filtering out untranslatable ones.
+ *
+ * @param events - Array of internal events
+ * @param context - Translation context
+ * @returns Array of MAP events (flattened)
+ */
+export declare function translateEvents(events: Event[], context?: TranslationContext): EventNotification[];
+/**
+ * Options for creating an event stream adapter.
+ */
+export interface EventStreamAdapterOptions {
+    /**
+     * Function to subscribe to internal events.
+     * Called with callback that receives events.
+     * Returns unsubscribe function.
+     */
+    subscribe: (callback: (event: Event) => void) => () => void;
+    /**
+     * Translation context.
+     */
+    context?: TranslationContext;
+}
+/**
+ * Create an event stream adapter that translates internal events
+ * and calls handlers with MAP events.
+ *
+ * @param options - Adapter options
+ * @returns Object with onEvent registration and cleanup
+ */
+export declare function createEventStreamAdapter(options: EventStreamAdapterOptions): {
+    /**
+     * Register handler for MAP events.
+     * Returns unsubscribe function.
+     */
+    onEvent: (handler: (event: EventNotification) => void) => () => void;
+    /**
+     * Stop the adapter and clean up.
+     */
+    stop: () => void;
+};
+//# sourceMappingURL=event-translator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-translator.d.ts","sourceRoot":"","sources":["../../../src/map/adapter/event-translator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAyB,MAAM,6BAA6B,CAAC;AAEhF,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAOlE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAAE,GACjD;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;CAChC;AAkDD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CA2BnB;AAuLD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,EAAE,CAWrB;AAMD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAE5D;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG;IAC5E;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAErE;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CA0CA"}

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

@@ -0,0 +1,295 @@
+/**
+ * Event Translator - Translates internal EventStore events to MAP events
+ *
+ * Converts internal macro-agent events (spawn, terminate, status, message, task)
+ * to MAP protocol event format (EventNotification).
+ *
+ * Translation happens at the adapter boundary, keeping internal events unchanged.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import { ulid } from "ulid";
+// =============================================================================
+// Event Type Mapping
+// =============================================================================
+/**
+ * Map internal event types to MAP event types.
+ */
+const EVENT_TYPE_MAP = {
+    spawn: "agent.registered",
+    stop: "agent.unregistered",
+    status: "agent.state.changed",
+    message: ["message.sent", "message.delivered"], // Two events for message
+    task: null, // Handled specially based on payload
+    subscription: null, // Internal only, not exposed
+    peer_message: null, // Federation, handled separately
+    peer_request: null, // Federation, handled separately
+    conversation: null, // Mail: handled by mail module
+    turn: null, // Mail: handled by mail module
+    thread: null, // Mail: handled by mail module
+    session: null, // Internal session tracking
+};
+/**
+ * Map status types to agent state names.
+ */
+const STATUS_TO_STATE = {
+    started: "running",
+    checkpoint: "running",
+    blocked: "blocked",
+    discovery: "running",
+    completed: "completed",
+    failed: "failed",
+};
+/**
+ * Map task payload types to MAP event types.
+ */
+const TASK_EVENT_MAP = {
+    created: "task.created",
+    assigned: "task.assigned",
+    completed: "task.completed",
+    failed: "task.failed",
+};
+// =============================================================================
+// Translation Functions
+// =============================================================================
+/**
+ * Translate an internal EventStore event to MAP EventNotification(s).
+ *
+ * Some internal events (like message) produce multiple MAP events.
+ *
+ * @param event - Internal event from EventStore
+ * @param context - Optional translation context
+ * @returns Translation result with MAP events or reason for not translating
+ */
+export function translateEvent(event, context = {}) {
+    const generateEventId = context.generateEventId ?? (() => ulid());
+    switch (event.type) {
+        case "spawn":
+            return translateSpawnEvent(event, generateEventId);
+        case "stop":
+            return translateStopEvent(event, generateEventId);
+        case "status":
+            return translateStatusEvent(event, generateEventId);
+        case "message":
+            return translateMessageEvent(event, generateEventId);
+        case "task":
+            return translateTaskEvent(event, generateEventId);
+        case "subscription":
+        case "peer_message":
+        case "peer_request":
+            return { translated: false, reason: `Event type not exposed: ${event.type}` };
+        default:
+            return { translated: false, reason: `Unknown event type: ${event.type}` };
+    }
+}
+/**
+ * Translate spawn event to agent.registered.
+ */
+function translateSpawnEvent(event, generateEventId) {
+    const agentId = event.source.agent_id;
+    if (!agentId) {
+        return { translated: false, reason: "Spawn event missing agent_id" };
+    }
+    const notification = {
+        eventId: generateEventId(),
+        type: "agent.registered",
+        timestamp: event.timestamp,
+        data: {
+            agentId,
+            name: event.payload.name,
+            role: event.payload.role,
+            parent: event.payload.parent_id,
+            metadata: event.payload.metadata,
+        },
+        agentId,
+    };
+    return { translated: true, events: [notification] };
+}
+/**
+ * Translate stop event to agent.unregistered.
+ */
+function translateStopEvent(event, generateEventId) {
+    const agentId = event.source.agent_id;
+    if (!agentId) {
+        return { translated: false, reason: "Stop event missing agent_id" };
+    }
+    const notification = {
+        eventId: generateEventId(),
+        type: "agent.unregistered",
+        timestamp: event.timestamp,
+        data: {
+            agentId,
+            reason: event.payload.reason,
+            exitCode: event.payload.exit_code,
+        },
+        agentId,
+    };
+    return { translated: true, events: [notification] };
+}
+/**
+ * Translate status event to agent.state.changed.
+ */
+function translateStatusEvent(event, generateEventId) {
+    const agentId = event.source.agent_id;
+    if (!agentId) {
+        return { translated: false, reason: "Status event missing agent_id" };
+    }
+    const statusType = event.payload.status;
+    const state = STATUS_TO_STATE[statusType] ?? statusType;
+    const notification = {
+        eventId: generateEventId(),
+        type: "agent.state.changed",
+        timestamp: event.timestamp,
+        data: {
+            agentId,
+            state,
+            previousState: event.payload.previous_state,
+            message: event.payload.message,
+            metadata: event.payload.metadata,
+        },
+        agentId,
+    };
+    return { translated: true, events: [notification] };
+}
+/**
+ * Translate message event to message.sent and message.delivered.
+ *
+ * A single internal message event produces two MAP events:
+ * - message.sent: When message is sent
+ * - message.delivered: For each recipient (or one aggregated)
+ */
+function translateMessageEvent(event, generateEventId) {
+    const senderId = event.source.agent_id;
+    if (!senderId) {
+        return { translated: false, reason: "Message event missing sender agent_id" };
+    }
+    const events = [];
+    // message.sent event
+    const sentEvent = {
+        eventId: generateEventId(),
+        type: "message.sent",
+        timestamp: event.timestamp,
+        data: {
+            messageId: event.id,
+            from: senderId,
+            to: event.target?.address ?? event.target?.agent_id,
+            content: event.payload.content,
+            priority: event.payload.priority,
+            correlationId: event.metadata?.correlation_id,
+        },
+        agentId: senderId,
+    };
+    events.push(sentEvent);
+    // message.delivered event(s)
+    const delivered = event.target?.delivered ?? (event.target?.agent_id ? [event.target.agent_id] : []);
+    if (delivered.length > 0) {
+        const deliveredEvent = {
+            eventId: generateEventId(),
+            type: "message.delivered",
+            timestamp: event.timestamp,
+            data: {
+                messageId: event.id,
+                from: senderId,
+                to: delivered,
+                deliveredCount: delivered.length,
+            },
+            causedBy: [sentEvent.eventId],
+        };
+        events.push(deliveredEvent);
+    }
+    return { translated: true, events };
+}
+/**
+ * Translate task event to task.* events.
+ */
+function translateTaskEvent(event, generateEventId) {
+    const taskAction = event.payload.action;
+    const mapEventType = TASK_EVENT_MAP[taskAction];
+    if (!mapEventType) {
+        return { translated: false, reason: `Unknown task action: ${taskAction}` };
+    }
+    const notification = {
+        eventId: generateEventId(),
+        type: mapEventType,
+        timestamp: event.timestamp,
+        data: {
+            taskId: event.payload.task_id,
+            title: event.payload.title,
+            description: event.payload.description,
+            assignee: event.payload.assignee,
+            status: event.payload.status,
+            result: event.payload.result,
+            error: event.payload.error,
+        },
+        agentId: event.source.agent_id,
+    };
+    return { translated: true, events: [notification] };
+}
+// =============================================================================
+// Batch Translation
+// =============================================================================
+/**
+ * Translate multiple events, filtering out untranslatable ones.
+ *
+ * @param events - Array of internal events
+ * @param context - Translation context
+ * @returns Array of MAP events (flattened)
+ */
+export function translateEvents(events, context = {}) {
+    const results = [];
+    for (const event of events) {
+        const result = translateEvent(event, context);
+        if (result.translated) {
+            results.push(...result.events);
+        }
+    }
+    return results;
+}
+/**
+ * Create an event stream adapter that translates internal events
+ * and calls handlers with MAP events.
+ *
+ * @param options - Adapter options
+ * @returns Object with onEvent registration and cleanup
+ */
+export function createEventStreamAdapter(options) {
+    const handlers = new Set();
+    let unsubscribe = null;
+    // Start subscription when first handler is added
+    const ensureSubscription = () => {
+        if (unsubscribe)
+            return;
+        unsubscribe = options.subscribe((event) => {
+            const result = translateEvent(event, options.context);
+            if (result.translated) {
+                for (const mapEvent of result.events) {
+                    for (const handler of handlers) {
+                        try {
+                            handler(mapEvent);
+                        }
+                        catch (error) {
+                            console.error("[EventStreamAdapter] Handler error:", error);
+                        }
+                    }
+                }
+            }
+        });
+    };
+    return {
+        onEvent(handler) {
+            handlers.add(handler);
+            ensureSubscription();
+            return () => {
+                handlers.delete(handler);
+                // Keep subscription active even with no handlers
+                // (adapter might be reused)
+            };
+        },
+        stop() {
+            unsubscribe?.();
+            unsubscribe = null;
+            handlers.clear();
+        },
+    };
+}
+//# sourceMappingURL=event-translator.js.map

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

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

package/dist/map/adapter/extensions/agent-detection.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent Detection Extension Methods
+ *
+ * Exposes CLI agent auto-detection to external MAP clients:
+ * - `_macro/agents/available` — List detected CLI agents (cached)
+ * - `_macro/agents/refresh` — Force a fresh detection scan
+ *
+ * Both methods are read-only queries gated by `canQuery`.
+ */
+import type { MAPAdapter } from "../interface.js";
+import type { DetectionResult } from "../../../agent-detection/types.js";
+/**
+ * Services required for agent detection extensions.
+ *
+ * Uses narrow method signatures rather than exposing the full AgentDetector
+ * to keep the contract minimal and testable.
+ */
+export interface AgentDetectionExtensionServices {
+    /**
+     * Get available agents, returning cached results when possible.
+     */
+    getAvailableAgents: (options?: {
+        refresh?: boolean;
+        includeNotInstalled?: boolean;
+    }) => Promise<DetectionResult>;
+    /**
+     * Whether a detection scan is currently running.
+     */
+    isDetecting: () => boolean;
+    /**
+     * Get cached result without triggering a new scan.
+     * Returns null if no results are available yet.
+     */
+    getCachedResult: () => DetectionResult | null;
+}
+/**
+ * Register agent detection extension methods with the MAPAdapter.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Agent detection services
+ */
+export declare function registerAgentDetectionExtensions(adapter: MAPAdapter, services: AgentDetectionExtensionServices): void;
+/**
+ * Unregister agent detection extension methods.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export declare function unregisterAgentDetectionExtensions(adapter: MAPAdapter): void;
+//# sourceMappingURL=agent-detection.d.ts.map

package/dist/map/adapter/extensions/agent-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detection.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/agent-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,mCAAmC,CAAC;AAsD3C;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,kBAAkB,EAAE,CAAC,OAAO,CAAC,EAAE;QAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAE/B;;OAEG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC/C;AA+ED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,+BAA+B,GACxC,IAAI,CASN;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAG5E"}

package/dist/map/adapter/extensions/agent-detection.js

@@ -0,0 +1,91 @@
+/**
+ * Agent Detection Extension Methods
+ *
+ * Exposes CLI agent auto-detection to external MAP clients:
+ * - `_macro/agents/available` — List detected CLI agents (cached)
+ * - `_macro/agents/refresh` — Force a fresh detection scan
+ *
+ * Both methods are read-only queries gated by `canQuery`.
+ */
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Convert internal DetectedAgent to public format.
+ * Strips filesystem paths for security.
+ */
+function toPublicAgent(agent) {
+    return {
+        id: agent.id,
+        name: agent.name,
+        installed: agent.installed,
+        version: agent.version,
+        vendor: agent.definition.vendor,
+        description: agent.definition.description,
+    };
+}
+// =============================================================================
+// Handler Implementations
+// =============================================================================
+function createAvailableHandler(services) {
+    return async (_context, params) => {
+        const { includeNotInstalled = false } = (params ?? {});
+        // Try cached result first
+        const cached = services.getCachedResult();
+        if (cached) {
+            const agents = includeNotInstalled
+                ? cached.agents
+                : cached.agents.filter((a) => a.installed);
+            return {
+                agents: agents.map(toPublicAgent),
+                scanned: cached.scanned,
+                durationMs: cached.durationMs,
+                cached: true,
+            };
+        }
+        // No cache — run detection
+        const result = await services.getAvailableAgents({ includeNotInstalled });
+        return {
+            agents: result.agents.map(toPublicAgent),
+            scanned: result.scanned,
+            durationMs: result.durationMs,
+            cached: false,
+        };
+    };
+}
+function createRefreshHandler(services) {
+    return async (_context, _params) => {
+        const result = await services.getAvailableAgents({
+            refresh: true,
+            includeNotInstalled: true,
+        });
+        return {
+            agents: result.agents.map(toPublicAgent),
+            scanned: result.scanned,
+            durationMs: result.durationMs,
+        };
+    };
+}
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * Register agent detection extension methods with the MAPAdapter.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Agent detection services
+ */
+export function registerAgentDetectionExtensions(adapter, services) {
+    adapter.registerExtension("_macro/agents/available", createAvailableHandler(services));
+    adapter.registerExtension("_macro/agents/refresh", createRefreshHandler(services));
+}
+/**
+ * Unregister agent detection extension methods.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export function unregisterAgentDetectionExtensions(adapter) {
+    adapter.unregisterExtension("_macro/agents/available");
+    adapter.unregisterExtension("_macro/agents/refresh");
+}
+//# sourceMappingURL=agent-detection.js.map

package/dist/map/adapter/extensions/agent-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detection.js","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/agent-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuFH,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAoB;IACzC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;QAC/B,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW;KAC1C,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,SAAS,sBAAsB,CAC7B,QAAyC;IAEzC,OAAO,KAAK,EAAE,QAA0B,EAAE,MAAe,EAAE,EAAE;QAC3D,MAAM,EAAE,mBAAmB,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAoB,CAAC;QAE1E,0BAA0B;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,mBAAmB;gBAChC,CAAC,CAAC,MAAM,CAAC,MAAM;gBACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAE7C,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;gBACjC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,IAAI;aACa,CAAC;QAC9B,CAAC;QAED,2BAA2B;QAC3B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAE1E,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;YACxC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,KAAK;SACY,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,QAAyC;IAEzC,OAAO,KAAK,EAAE,QAA0B,EAAE,OAAgB,EAAE,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC;YAC/C,OAAO,EAAE,IAAI;YACb,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;YACxC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;SACN,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAmB,EACnB,QAAyC;IAEzC,OAAO,CAAC,iBAAiB,CACvB,yBAAyB,EACzB,sBAAsB,CAAC,QAAQ,CAAC,CACjC,CAAC;IACF,OAAO,CAAC,iBAAiB,CACvB,uBAAuB,EACvB,oBAAoB,CAAC,QAAQ,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAmB;IACpE,OAAO,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;IACvD,OAAO,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;AACvD,CAAC"}

package/dist/map/adapter/extensions/agent-lifecycle.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Agent Lifecycle Extension Methods (_macro/spawnAgent, _macro/forkAgent, etc.)
+ *
+ * Exposes agent lifecycle management to external MAP clients via direct
+ * JSON-RPC extension calls, replacing the need for ACP-over-MAP streams.
+ *
+ * Methods:
+ * - _macro/spawnAgent - Spawn a child agent
+ * - _macro/forkAgent - Fork an agent's session
+ * - _macro/setPermissionMode - Change an agent's permission mode
+ * - _macro/respondToPermission - Respond to a pending permission request
+ */
+import type { MAPAdapter } from "../interface.js";
+import type { AgentId } from "../../../store/types/index.js";
+/**
+ * Services required for agent lifecycle extensions
+ */
+export interface AgentLifecycleExtensionServices {
+    /** Get agent by ID */
+    getAgent: (id: AgentId) => {
+        id: AgentId;
+        state: string;
+        session_id?: string;
+        cwd?: string | null;
+    } | null;
+    /** Spawn a child agent under a parent */
+    spawn: (opts: {
+        parent: AgentId;
+        task: string;
+        cwd?: string;
+        role?: string;
+        topics?: string[];
+        config?: Record<string, unknown>;
+    }) => Promise<{
+        id: AgentId;
+        session_id: string;
+    }>;
+    /** Fork an agent's session */
+    forkAgent: (agentId: AgentId, opts: {
+        name?: string;
+        prompt?: string;
+        cwd?: string;
+    }) => Promise<{
+        id: AgentId;
+        session_id: string;
+        session?: {
+            id: string;
+        };
+    }>;
+    /** Send a prompt to an agent (for fire-and-forget initial prompt on fork) */
+    prompt: (agentId: AgentId, message: string) => AsyncIterable<unknown>;
+    /** Set the permission mode for an agent's session */
+    setPermissionMode: (agentId: AgentId, mode: string) => boolean;
+    /** Get the current permission mode for an agent */
+    getPermissionMode: (agentId: AgentId) => string | null;
+    /** Respond to a pending permission request */
+    respondToPermission: (agentId: AgentId, requestId: string, optionId: string) => boolean;
+    /** Callback to notify subscribers that a new agent was registered */
+    onAgentRegistered?: (agent: {
+        id: string;
+        name?: string;
+        role?: string;
+        parent?: string;
+    }) => void;
+    /** List head manager agents (fallback parent for spawn) */
+    listHeadManagers: () => Array<{
+        id: AgentId;
+    }>;
+    /** Default working directory */
+    defaultCwd?: string;
+}
+/** All agent lifecycle extension method names */
+export declare const AGENT_LIFECYCLE_METHODS: readonly ["_macro/spawnAgent", "_macro/forkAgent", "_macro/setPermissionMode", "_macro/respondToPermission"];
+/**
+ * Register agent lifecycle extension methods with the MAPAdapter.
+ */
+export declare function registerAgentLifecycleExtensions(adapter: MAPAdapter, services: AgentLifecycleExtensionServices): void;
+/**
+ * Unregister agent lifecycle extension methods.
+ */
+export declare function unregisterAgentLifecycleExtensions(adapter: MAPAdapter): void;
+//# sourceMappingURL=agent-lifecycle.d.ts.map

package/dist/map/adapter/extensions/agent-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/agent-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAO7D;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,sBAAsB;IACtB,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAE3G,yCAAyC;IACzC,KAAK,EAAE,CAAC,IAAI,EAAE;QACZ,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnD,8BAA8B;IAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAE7E,6EAA6E;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC,OAAO,CAAC,CAAC;IAEtE,qDAAqD;IACrD,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAE/D,mDAAmD;IACnD,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAEvD,8CAA8C;IAC9C,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAExF,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAEnG,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,KAAK,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE/C,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6KD,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,8GAK1B,CAAC;AAEX;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,+BAA+B,GACxC,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAI5E"}