macro-agent 0.2.4 → 0.2.6

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

@@ -0,0 +1,197 @@
+/**
+ * Task Extension Methods (_macro/task/*)
+ *
+ * Exposes macro-agent's task management features to external MAP clients.
+ *
+ * Methods:
+ * - _macro/task/list - List tasks with filters
+ * - _macro/task/get - Get task details
+ * - _macro/task/create - Create new task
+ * - _macro/task/assign - Assign task to agent
+ * - _macro/task/complete - Mark task completed
+ * - _macro/task/send - Send message to task's assigned agent
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import { RPCError } from "../rpc-handler.js";
+// =============================================================================
+// Error Codes
+// =============================================================================
+const TASK_NOT_FOUND = -32020;
+function taskToInfo(task) {
+    return {
+        id: task.id,
+        description: task.description,
+        status: task.status,
+        assignedAgent: task.assigned_agent,
+        createdBy: task.created_by,
+        createdAt: task.created_at,
+        parentTask: task.parent_task,
+        isBlocked: task.isBlocked,
+        externalId: task.external_id,
+    };
+}
+// =============================================================================
+// Handler Implementations
+// =============================================================================
+function createListHandler(services) {
+    return async (_context, params) => {
+        const { filter } = (params ?? {});
+        const taskFilter = filter
+            ? {
+                status: filter.status,
+                assigned_agent: filter.assignedAgent,
+                parent_task: filter.parentTask,
+                created_by: filter.createdBy,
+                rootTasksOnly: filter.rootTasksOnly,
+                includeBlocked: filter.includeBlocked,
+            }
+            : undefined;
+        const tasks = await services.taskBackend.list(taskFilter);
+        return { tasks: tasks.map(taskToInfo) };
+    };
+}
+function createGetHandler(services) {
+    return async (_context, params) => {
+        const { taskId } = params;
+        if (!taskId) {
+            throw RPCError.invalidParams("taskId is required");
+        }
+        const task = await services.taskBackend.get(taskId);
+        if (!task) {
+            throw new RPCError(TASK_NOT_FOUND, `Task not found: ${taskId}`);
+        }
+        return { task: taskToInfo(task) };
+    };
+}
+function createCreateHandler(services) {
+    return async (context, params) => {
+        const { description, parentTask, externalId } = params;
+        if (!description) {
+            throw RPCError.invalidParams("description is required");
+        }
+        // Use participant ID as creator (external client)
+        const createdBy = `external:${context.participantId}`;
+        const options = {
+            description,
+            created_by: createdBy,
+            parent_task: parentTask,
+            external_id: externalId,
+        };
+        const task = await services.taskBackend.create(options);
+        return { task: taskToInfo(task) };
+    };
+}
+function createAssignHandler(services) {
+    return async (_context, params) => {
+        const { taskId, agentId, role, leaseMs } = params;
+        if (!taskId) {
+            throw RPCError.invalidParams("taskId is required");
+        }
+        if (!agentId) {
+            throw RPCError.invalidParams("agentId is required");
+        }
+        // Verify task exists
+        const task = await services.taskBackend.get(taskId);
+        if (!task) {
+            throw new RPCError(TASK_NOT_FOUND, `Task not found: ${taskId}`);
+        }
+        await services.taskBackend.assign(taskId, agentId, {
+            role,
+            leaseMs,
+        });
+        return { success: true };
+    };
+}
+function createCompleteHandler(services) {
+    return async (_context, params) => {
+        const { taskId, outputs } = params;
+        if (!taskId) {
+            throw RPCError.invalidParams("taskId is required");
+        }
+        // Verify task exists
+        const task = await services.taskBackend.get(taskId);
+        if (!task) {
+            throw new RPCError(TASK_NOT_FOUND, `Task not found: ${taskId}`);
+        }
+        // Auto-transition through intermediate states if needed.
+        // Valid path to "completed" requires in_progress status.
+        // pending → assigned → in_progress → completed
+        if (task.status === "pending" || task.status === "assigned") {
+            if (task.status === "pending" && !task.assigned_agent) {
+                // Assign to creator if not assigned yet
+                await services.taskBackend.assign(taskId, task.created_by, {});
+            }
+            await services.taskBackend.start(taskId);
+        }
+        const taskOutputs = outputs
+            ? {
+                summary: outputs.summary,
+                data: outputs.data,
+            }
+            : undefined;
+        await services.taskBackend.complete(taskId, taskOutputs);
+        return { success: true };
+    };
+}
+function createSendHandler(services) {
+    return async (context, params) => {
+        const { taskId, content, priority } = params;
+        if (!taskId) {
+            throw RPCError.invalidParams("taskId is required");
+        }
+        if (content === undefined) {
+            throw RPCError.invalidParams("content is required");
+        }
+        // Get task to find assigned agent
+        const task = await services.taskBackend.get(taskId);
+        if (!task) {
+            throw new RPCError(TASK_NOT_FOUND, `Task not found: ${taskId}`);
+        }
+        if (!task.assigned_agent) {
+            throw RPCError.invalidParams(`Task ${taskId} has no assigned agent`);
+        }
+        // Route message to the assigned agent
+        const from = `external:${context.participantId}`;
+        const to = { agent: task.assigned_agent };
+        const result = await services.sendMessage(from, to, content, { priority });
+        return {
+            delivered: result.delivered,
+            agentId: task.assigned_agent,
+        };
+    };
+}
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * Register task extension methods with the MAPAdapter.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Task extension services
+ */
+export function registerTaskExtensions(adapter, services) {
+    // Query operations (require canQuery)
+    adapter.registerExtension("_macro/task/list", createListHandler(services));
+    adapter.registerExtension("_macro/task/get", createGetHandler(services));
+    // Management operations (require canManageTasks)
+    adapter.registerExtension("_macro/task/create", createCreateHandler(services));
+    adapter.registerExtension("_macro/task/assign", createAssignHandler(services));
+    adapter.registerExtension("_macro/task/complete", createCompleteHandler(services));
+    // Messaging operation (require canMessage)
+    adapter.registerExtension("_macro/task/send", createSendHandler(services));
+}
+/**
+ * Unregister task extension methods.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export function unregisterTaskExtensions(adapter) {
+    adapter.unregisterExtension("_macro/task/list");
+    adapter.unregisterExtension("_macro/task/get");
+    adapter.unregisterExtension("_macro/task/create");
+    adapter.unregisterExtension("_macro/task/assign");
+    adapter.unregisterExtension("_macro/task/complete");
+    adapter.unregisterExtension("_macro/task/send");
+}
+//# sourceMappingURL=task.js.map

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

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

package/dist/map/adapter/extensions/update-metadata.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Agent Metadata Update Extension
+ *
+ * Exposes generic agent metadata updates to external MAP clients:
+ * - `_macro/agents/update` — Update name, plan, or arbitrary metadata for an agent
+ *
+ * Fields are persisted in the EventStore as out-of-band fields
+ * (not derived from events) and survive view rebuilds.
+ */
+import type { MAPAdapter } from "../interface.js";
+import type { Agent, AgentMetadataUpdate } from "../../../store/types/agents.js";
+/**
+ * Services required for the update-metadata extension.
+ */
+export interface UpdateMetadataExtensionServices {
+    /** Get agent by ID to verify existence */
+    getAgent: (agentId: string) => Agent | null;
+    /** Persist the metadata updates */
+    updateAgentMetadata: (agentId: string, updates: AgentMetadataUpdate) => void;
+}
+/**
+ * Register the agent metadata update extension method with the MAPAdapter.
+ */
+export declare function registerUpdateMetadataExtension(adapter: MAPAdapter, services: UpdateMetadataExtensionServices): void;
+/**
+ * Unregister the agent metadata update extension method.
+ */
+export declare function unregisterUpdateMetadataExtension(adapter: MAPAdapter): void;
+//# sourceMappingURL=update-metadata.d.ts.map

package/dist/map/adapter/extensions/update-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-metadata.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/update-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AA4BjF;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;IAC5C,mCAAmC;IACnC,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC9E;AA4DD;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,+BAA+B,GACxC,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAE3E"}

package/dist/map/adapter/extensions/update-metadata.js

@@ -0,0 +1,67 @@
+/**
+ * Agent Metadata Update Extension
+ *
+ * Exposes generic agent metadata updates to external MAP clients:
+ * - `_macro/agents/update` — Update name, plan, or arbitrary metadata for an agent
+ *
+ * Fields are persisted in the EventStore as out-of-band fields
+ * (not derived from events) and survive view rebuilds.
+ */
+// =============================================================================
+// Handler Implementation
+// =============================================================================
+function createUpdateMetadataHandler(services) {
+    return async (_context, params) => {
+        const { agentId, name, plan, metadata } = (params ?? {});
+        if (!agentId) {
+            throw new Error("agentId is required");
+        }
+        // Must provide at least one field to update
+        if (name === undefined && plan === undefined && metadata === undefined) {
+            throw new Error("At least one field to update is required (name, plan, or metadata)");
+        }
+        if (name !== undefined && !name.trim()) {
+            throw new Error("name must not be empty");
+        }
+        const agent = services.getAgent(agentId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        const updates = {};
+        const updatedFields = [];
+        if (name !== undefined) {
+            updates.name = name.trim();
+            updatedFields.push("name");
+        }
+        if (plan !== undefined) {
+            updates.plan = plan;
+            updatedFields.push("plan");
+        }
+        if (metadata !== undefined) {
+            updates.metadata = metadata;
+            updatedFields.push("metadata");
+        }
+        services.updateAgentMetadata(agentId, updates);
+        return {
+            success: true,
+            agentId,
+            updated: updatedFields,
+        };
+    };
+}
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * Register the agent metadata update extension method with the MAPAdapter.
+ */
+export function registerUpdateMetadataExtension(adapter, services) {
+    adapter.registerExtension("_macro/agents/update", createUpdateMetadataHandler(services));
+}
+/**
+ * Unregister the agent metadata update extension method.
+ */
+export function unregisterUpdateMetadataExtension(adapter) {
+    adapter.unregisterExtension("_macro/agents/update");
+}
+//# sourceMappingURL=update-metadata.js.map

package/dist/map/adapter/extensions/update-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-metadata.js","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/update-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,SAAS,2BAA2B,CAClC,QAAyC;IAEzC,OAAO,KAAK,EAAE,QAA0B,EAAE,MAAe,EAAE,EAAE;QAC3D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAkC,CAAC;QAE1F,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,4CAA4C;QAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC5B,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QAED,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE/C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,OAAO,EAAE,aAAa;SACQ,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAmB,EACnB,QAAyC;IAEzC,OAAO,CAAC,iBAAiB,CACvB,sBAAsB,EACtB,2BAA2B,CAAC,QAAQ,CAAC,CACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAmB;IACnE,OAAO,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * Wake Extension Method (_macro/wake)
+ *
+ * Exposes agent wake functionality to external MAP clients.
+ * Allows external clients to wake sleeping agents with optional context.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { MAPAdapter } from "../interface.js";
+import type { AgentId } from "../../../store/types/index.js";
+/**
+ * Session info for wake decisions
+ */
+export interface SessionInfo {
+    hasSession: boolean;
+    isPrompting: boolean;
+    supportsInjection: boolean;
+}
+/**
+ * Services required for wake extension
+ */
+export interface WakeExtensionServices {
+    /**
+     * Get agent by ID
+     */
+    getAgent: (agentId: AgentId) => {
+        id: AgentId;
+        state: string;
+    } | undefined;
+    /**
+     * Get session info for an agent
+     */
+    getSessionInfo: (agentId: AgentId) => SessionInfo;
+    /**
+     * Send a prompt/message to an agent
+     */
+    prompt: (agentId: AgentId, message: string) => Promise<void>;
+    /**
+     * Inject context into an agent's session
+     */
+    inject?: (agentId: AgentId, message: string) => Promise<boolean>;
+    /**
+     * Interrupt an agent with a message
+     */
+    interrupt?: (agentId: AgentId, message: string) => Promise<boolean>;
+}
+/**
+ * Register wake extension method with the MAPAdapter.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Wake extension services
+ */
+export declare function registerWakeExtension(adapter: MAPAdapter, services: WakeExtensionServices): void;
+/**
+ * Unregister wake extension method.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export declare function unregisterWakeExtension(adapter: MAPAdapter): void;
+//# sourceMappingURL=wake.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wake.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/wake.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AA8B7D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAE3E;;OAEG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,WAAW,CAAC;IAElD;;OAEG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AA6ID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEjE"}

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

@@ -0,0 +1,144 @@
+/**
+ * Wake Extension Method (_macro/wake)
+ *
+ * Exposes agent wake functionality to external MAP clients.
+ * Allows external clients to wake sleeping agents with optional context.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import { RPCError } from "../rpc-handler.js";
+// =============================================================================
+// Wake Logic
+// =============================================================================
+/**
+ * Determine wake action based on agent state and priority
+ */
+function determineWakeAction(sessionInfo, priority) {
+    // If agent is currently prompting (active), usually skip
+    if (sessionInfo.isPrompting) {
+        // Only interrupt for urgent priority
+        if (priority === "urgent" && sessionInfo.supportsInjection) {
+            return "interrupt";
+        }
+        return "skip";
+    }
+    // Agent not prompting - determine wake strategy
+    if (!sessionInfo.hasSession) {
+        // No session - need to wake
+        return "wake";
+    }
+    // Has session but not prompting - try injection based on priority
+    if (priority === "urgent" || priority === "high") {
+        if (sessionInfo.supportsInjection) {
+            return "inject";
+        }
+        return "wake";
+    }
+    // Normal/low priority - queue or wake
+    return "wake";
+}
+// =============================================================================
+// Handler Implementation
+// =============================================================================
+function createWakeHandler(services) {
+    return async (_context, params) => {
+        const { agentId, message, priority = "normal" } = (params ?? {});
+        if (!agentId) {
+            throw RPCError.invalidParams("agentId is required");
+        }
+        // Check agent exists
+        const agent = services.getAgent(agentId);
+        if (!agent) {
+            throw RPCError.notFound("agent", agentId);
+        }
+        // Check agent state
+        if (agent.state === "stopped" || agent.state === "failed") {
+            throw RPCError.invalidParams(`Agent ${agentId} is ${agent.state} and cannot be woken`);
+        }
+        // Get session info
+        const sessionInfo = services.getSessionInfo(agentId);
+        // Check if already active
+        if (sessionInfo.isPrompting) {
+            // Agent is already active
+            if (priority !== "urgent") {
+                return {
+                    success: true,
+                    alreadyActive: true,
+                };
+            }
+            // For urgent, try to interrupt
+        }
+        // Determine wake action
+        const action = determineWakeAction(sessionInfo, priority);
+        if (action === "skip") {
+            return {
+                success: true,
+                alreadyActive: true,
+            };
+        }
+        // Format wake message
+        const wakeMessage = message ?? "Wake requested by external client";
+        // Execute wake action
+        let actionTaken;
+        switch (action) {
+            case "interrupt":
+                if (services.interrupt) {
+                    await services.interrupt(agentId, wakeMessage);
+                    actionTaken = "interrupted";
+                }
+                else {
+                    // Fallback to prompt
+                    await services.prompt(agentId, wakeMessage);
+                    actionTaken = "woken";
+                }
+                break;
+            case "inject":
+                if (services.inject) {
+                    const injected = await services.inject(agentId, wakeMessage);
+                    actionTaken = injected ? "injected" : "woken";
+                    if (!injected) {
+                        // Injection failed, fall back to prompt
+                        await services.prompt(agentId, wakeMessage);
+                    }
+                }
+                else {
+                    // No inject support, use prompt
+                    await services.prompt(agentId, wakeMessage);
+                    actionTaken = "woken";
+                }
+                break;
+            case "wake":
+            case "queue":
+            default:
+                await services.prompt(agentId, wakeMessage);
+                actionTaken = "woken";
+                break;
+        }
+        return {
+            success: true,
+            alreadyActive: false,
+            action: actionTaken,
+        };
+    };
+}
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * Register wake extension method with the MAPAdapter.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Wake extension services
+ */
+export function registerWakeExtension(adapter, services) {
+    adapter.registerExtension("_macro/wake", createWakeHandler(services));
+}
+/**
+ * Unregister wake extension method.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export function unregisterWakeExtension(adapter) {
+    adapter.unregisterExtension("_macro/wake");
+}
+//# sourceMappingURL=wake.js.map

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

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

package/dist/map/adapter/extensions/workspace-files.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Workspace File Search Extension Methods (_macro/workspace/files/*)
+ *
+ * Exposes file search and read capabilities for agent workspaces to
+ * external MAP clients (e.g., TUI file attachment system).
+ *
+ * Methods:
+ * - _macro/workspace/files/search - Search files by query
+ * - _macro/workspace/files/list - List files in a directory
+ * - _macro/workspace/files/read - Read file contents
+ *
+ * Security: All file operations are scoped to the agent's workspace path.
+ * Path traversal is rejected.
+ *
+ * @see specs/s-5vx8 File Attachment System
+ */
+import type { MAPAdapter } from "../interface.js";
+import type { AgentId } from "../../../store/types/index.js";
+import type { InternalWorkspace } from "./workspace.js";
+/**
+ * Services required for workspace file search extension
+ */
+export interface WorkspaceFileServices {
+    /** Get workspace for an agent */
+    getWorkspace: (agentId: AgentId) => InternalWorkspace | null;
+    /** Check if agent exists */
+    agentExists: (agentId: AgentId) => boolean;
+}
+/**
+ * Register workspace file search extension methods with the MAPAdapter.
+ *
+ * @param adapter - MAPAdapter instance
+ * @param services - Workspace file search services
+ */
+export declare function registerWorkspaceFileExtensions(adapter: MAPAdapter, services: WorkspaceFileServices): void;
+/**
+ * Unregister workspace file search extension methods.
+ *
+ * @param adapter - MAPAdapter instance
+ */
+export declare function unregisterWorkspaceFileExtensions(adapter: MAPAdapter): void;
+//# sourceMappingURL=workspace-files.d.ts.map

package/dist/map/adapter/extensions/workspace-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-files.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/workspace-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAwHxD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,iBAAiB,GAAG,IAAI,CAAC;IAC7D,4BAA4B;IAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC5C;AAqRD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAIN;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAI3E"}