macro-agent 0.1.0 → 0.1.1

package/src/map/adapter/extensions/task.ts

@@ -226,6 +226,17 @@ function createCompleteHandler(services: TaskExtensionServices): ExtensionHandle
       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 as TaskId, task.created_by, {});
+      }
+      await services.taskBackend.start(taskId as TaskId);
+    }
+
     const taskOutputs: TaskOutputs | undefined = outputs
       ? {
           summary: outputs.summary,

package/src/map/adapter/extensions/update-metadata.ts

@@ -0,0 +1,126 @@
+/**
+ * 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, ExtensionHandler, ExtensionContext } from "../interface.js";
+import type { Agent, AgentMetadataUpdate } from "../../../store/types/agents.js";
+
+// =============================================================================
+// Request/Response Types
+// =============================================================================
+
+interface UpdateMetadataParams {
+  /** Agent ID to update */
+  agentId: string;
+  /** New display name */
+  name?: string;
+  /** Plan entries */
+  plan?: Array<{ content: string; priority: string; status: string }>;
+  /** Arbitrary metadata (shallow-merged with existing) */
+  metadata?: Record<string, unknown>;
+}
+
+interface UpdateMetadataResult {
+  success: boolean;
+  agentId: string;
+  /** List of fields that were updated */
+  updated: string[];
+}
+
+// =============================================================================
+// Extension Services
+// =============================================================================
+
+/**
+ * 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;
+}
+
+// =============================================================================
+// Handler Implementation
+// =============================================================================
+
+function createUpdateMetadataHandler(
+  services: UpdateMetadataExtensionServices,
+): ExtensionHandler {
+  return async (_context: ExtensionContext, params: unknown) => {
+    const { agentId, name, plan, metadata } = (params ?? {}) as Partial<UpdateMetadataParams>;
+
+    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: AgentMetadataUpdate = {};
+    const updatedFields: string[] = [];
+
+    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,
+    } satisfies UpdateMetadataResult;
+  };
+}
+
+// =============================================================================
+// Registration
+// =============================================================================
+
+/**
+ * Register the agent metadata update extension method with the MAPAdapter.
+ */
+export function registerUpdateMetadataExtension(
+  adapter: MAPAdapter,
+  services: UpdateMetadataExtensionServices,
+): void {
+  adapter.registerExtension(
+    "_macro/agents/update",
+    createUpdateMetadataHandler(services),
+  );
+}
+
+/**
+ * Unregister the agent metadata update extension method.
+ */
+export function unregisterUpdateMetadataExtension(adapter: MAPAdapter): void {
+  adapter.unregisterExtension("_macro/agents/update");
+}

package/src/map/adapter/index.ts

@@ -94,6 +94,18 @@ export {
   type EventStreamAdapterOptions,
 } from "./event-translator.js";
 
+// Event log (replay support)
+export {
+  EventLog,
+  underscoreToDot,
+  dotToUnderscore,
+  type EventLogConfig,
+  type LoggedEvent,
+  type EventLogQueryParams,
+  type EventLogFilter,
+  type EventLogQueryResult,
+} from "./event-log.js";
+
 // WebSocket integration
 export {
   createMAPWebSocketHandler,
@@ -116,15 +128,31 @@ export {
   unregisterWorkspaceExtension,
   registerWorkspaceFileExtensions,
   unregisterWorkspaceFileExtensions,
+  registerUpdateMetadataExtension,
+  unregisterUpdateMetadataExtension,
+  registerMCPBridgeExtensions,
+  unregisterMCPBridgeExtensions,
   // Constants
   MACRO_EXTENSION_METHODS,
   EXTENSION_CAPABILITIES,
+  MCP_BRIDGE_METHODS,
   // Types
   type MacroExtensionServices,
   type TaskExtensionServices,
   type WakeExtensionServices,
   type WorkspaceExtensionServices,
   type WorkspaceFileServices,
+  type UpdateMetadataExtensionServices,
+  type MCPBridgeServices,
   type SessionInfo,
   type InternalWorkspace,
+  // Agent lifecycle
+  registerAgentLifecycleExtensions,
+  unregisterAgentLifecycleExtensions,
+  AGENT_LIFECYCLE_METHODS,
+  type AgentLifecycleExtensionServices,
+  // Resume
+  registerResumeExtension,
+  unregisterResumeExtension,
+  type ResumeExtensionServices,
 } from "./extensions/index.js";

package/src/map/adapter/interface.ts

@@ -147,6 +147,8 @@ export interface AdapterLimits {
   maxMessageSize?: number;
   /** Request timeout in milliseconds */
   requestTimeoutMs?: number;
+  /** Maximum events stored in replay buffer (default: 10000) */
+  maxReplayBufferSize?: number;
 }
 
 /**