macro-agent 0.2.4 → 0.2.6

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

@@ -0,0 +1,164 @@
+/**
+ * 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 { RPCError } from "../rpc-handler.js";
+// =============================================================================
+// Handler Implementations
+// =============================================================================
+function createSpawnHandler(services) {
+    return async (_context, params) => {
+        const { task, cwd, topics, config, parentId } = (params ?? {});
+        if (!task) {
+            throw RPCError.invalidParams("task is required");
+        }
+        // Determine parent: explicit parentId, or fall back to head manager
+        let parent;
+        if (parentId) {
+            parent = parentId;
+        }
+        else {
+            const headManagers = services.listHeadManagers();
+            if (headManagers.length > 0) {
+                parent = headManagers[0].id;
+            }
+        }
+        if (!parent) {
+            throw RPCError.invalidParams("No parent agent available for spawning");
+        }
+        const spawned = await services.spawn({
+            parent,
+            task,
+            cwd: cwd ?? services.defaultCwd,
+            role: "worker",
+            topics,
+            config,
+        });
+        // Notify subscribers that a new agent was registered
+        if (services.onAgentRegistered) {
+            const agent = services.getAgent(spawned.id);
+            services.onAgentRegistered({
+                id: spawned.id,
+                name: agent?.id,
+                role: "worker",
+                parent: parent,
+            });
+        }
+        return {
+            agentId: spawned.id,
+            sessionId: spawned.session_id,
+        };
+    };
+}
+function createForkHandler(services) {
+    return async (_context, params) => {
+        const { agentId, name, prompt, cwd } = (params ?? {});
+        if (!agentId) {
+            throw RPCError.invalidParams("agentId is required");
+        }
+        const sourceAgent = services.getAgent(agentId);
+        if (!sourceAgent) {
+            throw RPCError.notFound("agent", agentId);
+        }
+        const forked = await services.forkAgent(agentId, {
+            name,
+            prompt,
+            cwd: cwd ?? sourceAgent.cwd ?? services.defaultCwd,
+        });
+        // Notify subscribers
+        if (services.onAgentRegistered) {
+            services.onAgentRegistered({
+                id: forked.id,
+                name,
+                parent: sourceAgent.id,
+            });
+        }
+        // Fire-and-forget initial prompt if provided
+        if (prompt && forked.id) {
+            (async () => {
+                try {
+                    for await (const _chunk of services.prompt(forked.id, prompt)) {
+                        // drain iterator
+                    }
+                }
+                catch {
+                    // best-effort
+                }
+            })();
+        }
+        return {
+            newAgentId: forked.id,
+            newSessionId: forked.session_id,
+            originalAgentId: agentId,
+            providerSessionId: forked.session?.id,
+        };
+    };
+}
+function createSetPermissionModeHandler(services) {
+    return async (_context, params) => {
+        const { agentId, permissionMode } = (params ?? {});
+        if (!agentId || !permissionMode) {
+            throw RPCError.invalidParams("agentId and permissionMode are required");
+        }
+        const previousMode = services.getPermissionMode(agentId);
+        const success = services.setPermissionMode(agentId, permissionMode);
+        if (!success) {
+            return {
+                success: false,
+                error: `No active session found for agent ${agentId}`,
+            };
+        }
+        return {
+            success: true,
+            agentId,
+            previousMode,
+            newMode: permissionMode,
+        };
+    };
+}
+function createRespondToPermissionHandler(services) {
+    return async (_context, params) => {
+        const { agentId, requestId, optionId } = (params ?? {});
+        if (!agentId || !requestId || !optionId) {
+            throw RPCError.invalidParams("agentId, requestId, and optionId are required");
+        }
+        const success = services.respondToPermission(agentId, requestId, optionId);
+        return { success };
+    };
+}
+// =============================================================================
+// Registration
+// =============================================================================
+/** All agent lifecycle extension method names */
+export const AGENT_LIFECYCLE_METHODS = [
+    "_macro/spawnAgent",
+    "_macro/forkAgent",
+    "_macro/setPermissionMode",
+    "_macro/respondToPermission",
+];
+/**
+ * Register agent lifecycle extension methods with the MAPAdapter.
+ */
+export function registerAgentLifecycleExtensions(adapter, services) {
+    adapter.registerExtension("_macro/spawnAgent", createSpawnHandler(services));
+    adapter.registerExtension("_macro/forkAgent", createForkHandler(services));
+    adapter.registerExtension("_macro/setPermissionMode", createSetPermissionModeHandler(services));
+    adapter.registerExtension("_macro/respondToPermission", createRespondToPermissionHandler(services));
+}
+/**
+ * Unregister agent lifecycle extension methods.
+ */
+export function unregisterAgentLifecycleExtensions(adapter) {
+    for (const method of AGENT_LIFECYCLE_METHODS) {
+        adapter.unregisterExtension(method);
+    }
+}
+//# sourceMappingURL=agent-lifecycle.js.map

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

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

package/dist/map/adapter/extensions/cognitive.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cognitive Extension Methods (_macro/cognitive/*)
+ *
+ * Exposes Atlas cognitive operations to external MAP clients.
+ *
+ * Methods:
+ * - _macro/cognitive/command - Dispatch Atlas operations (extract, prune, query)
+ * - _macro/cognitive/status  - Query Atlas availability
+ * - _macro/cognitive/query   - Shorthand for synchronous memory query
+ */
+import type { MAPAdapter } from "../interface.js";
+import type { AtlasInstance } from "../../../cognitive/types.js";
+import type { EventStore } from "../../../store/event-store.js";
+export interface CognitiveExtensionServices {
+    atlas: AtlasInstance;
+    eventStore: EventStore;
+}
+export declare const COGNITIVE_EXTENSION_METHODS: readonly ["_macro/cognitive/command", "_macro/cognitive/status", "_macro/cognitive/query"];
+/**
+ * Register cognitive extension methods with the MAPAdapter.
+ */
+export declare function registerCognitiveExtensions(adapter: MAPAdapter, services: CognitiveExtensionServices): void;
+/**
+ * Unregister cognitive extension methods.
+ */
+export declare function unregisterCognitiveExtensions(adapter: MAPAdapter): void;
+//# sourceMappingURL=cognitive.d.ts.map

package/dist/map/adapter/extensions/cognitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/cognitive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAShE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;CACxB;AAoKD,eAAO,MAAM,2BAA2B,4FAI9B,CAAC;AAEX;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAIvE"}

package/dist/map/adapter/extensions/cognitive.js

@@ -0,0 +1,158 @@
+/**
+ * Cognitive Extension Methods (_macro/cognitive/*)
+ *
+ * Exposes Atlas cognitive operations to external MAP clients.
+ *
+ * Methods:
+ * - _macro/cognitive/command - Dispatch Atlas operations (extract, prune, query)
+ * - _macro/cognitive/status  - Query Atlas availability
+ * - _macro/cognitive/query   - Shorthand for synchronous memory query
+ */
+import { RPCError } from "../rpc-handler.js";
+import { nanoid } from "nanoid";
+// =============================================================================
+// Handler Implementations
+// =============================================================================
+function createCommandHandler(services) {
+    return async (_context, params) => {
+        const { operation, config, job_id } = (params ?? {});
+        if (!operation) {
+            throw RPCError.invalidParams("operation is required");
+        }
+        const jobId = job_id ?? `cog_${nanoid(8)}`;
+        switch (operation) {
+            case "query": {
+                const query = config?.query;
+                if (!query) {
+                    throw RPCError.invalidParams("config.query is required for query operation");
+                }
+                const result = await services.atlas.queryMemory(query, {
+                    domains: config?.domains,
+                    includeExperiences: config?.includeExperiences,
+                    includePlaybooks: config?.includePlaybooks,
+                });
+                return { job_id: jobId, status: "completed", result };
+            }
+            case "extract": {
+                // Fire-and-forget: start batch learning, emit event when done
+                runAsyncOperation(services, jobId, async () => {
+                    return await services.atlas.runBatchLearning();
+                });
+                return { job_id: jobId, status: "started" };
+            }
+            case "team-extract": {
+                if (!services.atlas.runTeamBatchLearning) {
+                    throw RPCError.invalidParams("team-extract is not supported by this Atlas instance");
+                }
+                const atlas = services.atlas;
+                runAsyncOperation(services, jobId, async () => {
+                    return await atlas.runTeamBatchLearning();
+                });
+                return { job_id: jobId, status: "started" };
+            }
+            case "prune": {
+                if (!services.atlas.prune) {
+                    throw RPCError.invalidParams("prune is not supported by this Atlas instance");
+                }
+                const atlas = services.atlas;
+                runAsyncOperation(services, jobId, async () => {
+                    return await atlas.prune(config);
+                });
+                return { job_id: jobId, status: "started" };
+            }
+            default:
+                throw RPCError.invalidParams(`Unknown operation: ${operation}`);
+        }
+    };
+}
+function createStatusHandler(services) {
+    return async (_context, _params) => {
+        const operations = ["extract", "query"];
+        if (services.atlas.runTeamBatchLearning) {
+            operations.push("team-extract");
+        }
+        if (services.atlas.prune) {
+            operations.push("prune");
+        }
+        return {
+            available: true,
+            operations,
+        };
+    };
+}
+function createQueryHandler(services) {
+    return async (_context, params) => {
+        const { query, options } = (params ?? {});
+        if (!query) {
+            throw RPCError.invalidParams("query is required");
+        }
+        const result = await services.atlas.queryMemory(query, options);
+        return { result };
+    };
+}
+// =============================================================================
+// Async operation helper
+// =============================================================================
+function runAsyncOperation(services, jobId, fn) {
+    // Fire-and-forget: run operation, emit result event when done
+    fn()
+        .then((result) => {
+        try {
+            services.eventStore.emit({
+                type: "status",
+                source: { agent_id: "cognitive-backend" },
+                payload: {
+                    status_type: "cognitive_result",
+                    job_id: jobId,
+                    status: "completed",
+                    result,
+                },
+            });
+        }
+        catch {
+            // Best-effort event emission
+        }
+    })
+        .catch((err) => {
+        try {
+            services.eventStore.emit({
+                type: "status",
+                source: { agent_id: "cognitive-backend" },
+                payload: {
+                    status_type: "cognitive_result",
+                    job_id: jobId,
+                    status: "failed",
+                    error: err instanceof Error ? err.message : String(err),
+                },
+            });
+        }
+        catch {
+            // Best-effort event emission
+        }
+    });
+}
+// =============================================================================
+// Registration
+// =============================================================================
+export const COGNITIVE_EXTENSION_METHODS = [
+    "_macro/cognitive/command",
+    "_macro/cognitive/status",
+    "_macro/cognitive/query",
+];
+/**
+ * Register cognitive extension methods with the MAPAdapter.
+ */
+export function registerCognitiveExtensions(adapter, services) {
+    adapter.registerExtension("_macro/cognitive/command", createCommandHandler(services));
+    adapter.registerExtension("_macro/cognitive/status", createStatusHandler(services));
+    adapter.registerExtension("_macro/cognitive/query", createQueryHandler(services));
+}
+/**
+ * Unregister cognitive extension methods.
+ */
+export function unregisterCognitiveExtensions(adapter) {
+    for (const method of COGNITIVE_EXTENSION_METHODS) {
+        adapter.unregisterExtension(method);
+    }
+}
+//# sourceMappingURL=cognitive.js.map

package/dist/map/adapter/extensions/cognitive.js.map

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

package/dist/map/adapter/extensions/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * MAP Adapter Extensions
+ *
+ * Exports all macro-agent specific extension methods for the MAP adapter.
+ * These methods expose macro-agent features to external clients via
+ * the `_macro/*` namespace.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+export { registerTaskExtensions, unregisterTaskExtensions, type TaskExtensionServices, } from "./task.js";
+export { registerWakeExtension, unregisterWakeExtension, type WakeExtensionServices, type SessionInfo, } from "./wake.js";
+export { registerWorkspaceExtension, unregisterWorkspaceExtension, type WorkspaceExtensionServices, type InternalWorkspace, } from "./workspace.js";
+export { registerWorkspaceFileExtensions, unregisterWorkspaceFileExtensions, type WorkspaceFileServices, } from "./workspace-files.js";
+export { registerResumeExtension, unregisterResumeExtension, type ResumeExtensionServices, } from "./resume.js";
+export { registerAgentDetectionExtensions, unregisterAgentDetectionExtensions, type AgentDetectionExtensionServices, } from "./agent-detection.js";
+export { registerUpdateMetadataExtension, unregisterUpdateMetadataExtension, type UpdateMetadataExtensionServices, } from "./update-metadata.js";
+export { registerMCPBridgeExtensions, unregisterMCPBridgeExtensions, MCP_BRIDGE_METHODS, type MCPBridgeServices, } from "./mcp-bridge.js";
+export { registerAgentLifecycleExtensions, unregisterAgentLifecycleExtensions, AGENT_LIFECYCLE_METHODS, type AgentLifecycleExtensionServices, } from "./agent-lifecycle.js";
+export { registerStreamExtensions, unregisterStreamExtensions, STREAM_EXTENSION_METHODS, type StreamExtensionServices, } from "./streams.js";
+export { registerCognitiveExtensions, unregisterCognitiveExtensions, COGNITIVE_EXTENSION_METHODS, type CognitiveExtensionServices, } from "./cognitive.js";
+import type { MAPAdapter } from "../interface.js";
+import type { TaskExtensionServices } from "./task.js";
+import type { WakeExtensionServices } from "./wake.js";
+import type { WorkspaceExtensionServices } from "./workspace.js";
+import type { WorkspaceFileServices } from "./workspace-files.js";
+import type { ResumeExtensionServices } from "./resume.js";
+import type { AgentDetectionExtensionServices } from "./agent-detection.js";
+import type { UpdateMetadataExtensionServices } from "./update-metadata.js";
+import type { MCPBridgeServices } from "./mcp-bridge.js";
+import type { AgentLifecycleExtensionServices } from "./agent-lifecycle.js";
+import type { StreamExtensionServices } from "./streams.js";
+import type { CognitiveExtensionServices } from "./cognitive.js";
+/**
+ * All services required for macro-agent extensions
+ */
+export interface MacroExtensionServices {
+    task?: TaskExtensionServices;
+    wake?: WakeExtensionServices;
+    workspace?: WorkspaceExtensionServices;
+    workspaceFiles?: WorkspaceFileServices;
+    resume?: ResumeExtensionServices;
+    agentDetection?: AgentDetectionExtensionServices;
+    updateMetadata?: UpdateMetadataExtensionServices;
+    mcpBridge?: MCPBridgeServices;
+    agentLifecycle?: AgentLifecycleExtensionServices;
+    streams?: StreamExtensionServices;
+    cognitive?: CognitiveExtensionServices;
+}
+/**
+ * Register all available macro-agent extension methods.
+ *
+ * Only registers extensions for which services are provided.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Extension services (partial - only registers what's provided)
+ *
+ * @example
+ * ```typescript
+ * registerMacroExtensions(adapter, {
+ *   task: {
+ *     taskBackend,
+ *     sendMessage: messageRouter.sendToAddress.bind(messageRouter),
+ *   },
+ *   wake: {
+ *     getAgent: agentManager.get.bind(agentManager),
+ *     getSessionInfo: (id) => ({
+ *       hasSession: agentManager.hasActiveSession(id),
+ *       isPrompting: agentManager.isPrompting(id),
+ *       supportsInjection: agentManager.supportsInjection(id),
+ *     }),
+ *     prompt: async (id, msg) => { agentManager.prompt(id, msg); },
+ *   },
+ *   workspace: {
+ *     getWorkspace: workspaceManager.getWorkspace.bind(workspaceManager),
+ *     agentExists: (id) => agentManager.get(id) !== null,
+ *   },
+ * });
+ * ```
+ */
+export declare function registerMacroExtensions(adapter: MAPAdapter, services: MacroExtensionServices): void;
+/**
+ * Unregister all macro-agent extension methods.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export declare function unregisterMacroExtensions(adapter: MAPAdapter): void;
+/**
+ * List of all macro-agent extension methods
+ */
+export declare const MACRO_EXTENSION_METHODS: readonly ["_macro/task/list", "_macro/task/get", "_macro/task/create", "_macro/task/assign", "_macro/task/complete", "_macro/task/send", "_macro/wake", "_macro/workspace/info", "_macro/workspace/files/search", "_macro/workspace/files/list", "_macro/workspace/files/read", "_macro/resume", "_macro/agents/available", "_macro/agents/refresh", "_macro/agents/update", "_macro/mcp/spawn_agent", "_macro/mcp/emit_status", "_macro/mcp/send_message", "_macro/mcp/check_messages", "_macro/mcp/query_index", "_macro/mcp/get_hierarchy", "_macro/mcp/get_agent_summary", "_macro/mcp/stop_agent", "_macro/mcp/done", "_macro/mcp/inject_context", "_macro/mcp/wait_for_activity", "_macro/mcp/claim_task", "_macro/mcp/unclaim_task", "_macro/mcp/list_claimable_tasks", "_macro/mcp/send_peer_message", "_macro/mcp/send_peer_request", "_macro/mcp/respond_to_peer_request", "_macro/mcp/task_tools_list", "_macro/spawnAgent", "_macro/forkAgent", "_macro/setPermissionMode", "_macro/respondToPermission", "_macro/streams/list", "_macro/streams/get", "_macro/streams/hierarchy", "_macro/streams/createPR", "_macro/checkpoints/list", "_macro/checkpoints/get", "_macro/checkpoints/select", "_macro/diffStacks/list", "_macro/diffStacks/get", "_macro/diffStacks/create", "_macro/diffStacks/createPR", "_macro/mergeQueue/status", "_macro/mergeQueue/get", "_macro/cognitive/command", "_macro/cognitive/status", "_macro/cognitive/query"];
+/**
+ * Extension method to required capability mapping
+ */
+export declare const EXTENSION_CAPABILITIES: Record<string, string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/map/adapter/extensions/index.d.ts.map

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