@gethmy/mcp 2.9.9 → 2.11.0

package/README.md

@@ -5,7 +5,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 
 ## Features
 
-- **70 MCP Tools** for full board control, knowledge graph, and workflow plans
+- **71 MCP Tools** for full board control, knowledge graph, and workflow plans
 - **7 Global Skills** — `/hmy`, `/hmy-plan`, `/hmy-cleanup`, `/hmy-standup`, `/hmy-memory-prune`, `/hmy-upgrade`, `/hmy-review`, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
 - **Knowledge Graph Memory** — Phase 1 surface: hybrid retrieval (vector + lexical + RRF), session-scoped working memory, activity feed. See [docs/memory.md](../../docs/memory.md)
 - **GSD Workflow Plans** - plan/execute/verify/done lifecycle with auto card creation
@@ -255,6 +255,7 @@ Every skill ships with an `hmy-update-check` preamble that fires on invocation.
 - `harmony_list_projects` - List projects
 - `harmony_get_board` - Get board state (supports pagination via `limit`/`offset`, `summary` mode, `columnId` filter, `includeArchived`)
 - `harmony_get_workspace_members` - Get team members
+- `harmony_list_agents` - List a workspace's virtual agents (daemons); use the id with `harmony_assign_card` (`agentId`)
 - `harmony_set_workspace_context` - Set active workspace
 - `harmony_set_project_context` - Set active project
 - `harmony_get_context` - Get current context

package/dist/cli.js

@@ -1919,15 +1919,9 @@ class HarmonyApiClient {
   async endAgentSession(cardId, data) {
     return this.request("DELETE", `/cards/${cardId}/agent-context`, data);
   }
-  async flushActivityLog(cardId, data) {
-    return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
-  }
   async appendAgentRunEvents(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
   }
-  async getActivityLog(cardId, sessionId) {
-    return this.request("GET", `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`);
-  }
   async getPendingUserMessages(cardId, sessionId, sinceSeq) {
     return this.request("GET", `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`);
   }
@@ -3646,7 +3640,7 @@ var TOOLS = {
     }
   },
   harmony_assign_card: {
-    description: "Assign a card to a team member",
+    description: "Assign a card to a team member (human) or a virtual agent (e.g. the autonomous agent daemon). Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both. Use harmony_list_agents to find a virtual agent's id.",
     inputSchema: {
       type: "object",
       properties: {
@@ -3654,7 +3648,12 @@ var TOOLS = {
         assigneeId: {
           type: "string",
           nullable: true,
-          description: "User ID (null to unassign)"
+          description: "Human user ID (null to unassign). Mutually exclusive with agentId."
+        },
+        agentId: {
+          type: "string",
+          nullable: true,
+          description: "Virtual agent ID from harmony_list_agents (null to unassign). Setting it hands the card to the agent daemon. Mutually exclusive with assigneeId."
         }
       },
       required: ["cardId"]
@@ -4083,6 +4082,18 @@ var TOOLS = {
       }
     }
   },
+  harmony_list_agents: {
+    description: "List a workspace's virtual agents (autonomous agent daemons registered to the board). Returns each agent's id, identifier, name and last-seen time. Use the returned id with harmony_assign_card (agentId) to hand a card to the daemon.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspaceId: {
+          type: "string",
+          description: "Workspace ID (optional if context set)"
+        }
+      }
+    }
+  },
   harmony_set_workspace_context: {
     description: "Set the active workspace context for subsequent operations",
     inputSchema: {
@@ -5203,8 +5214,16 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_assign_card": {
       const cardId = z.string().uuid().parse(args.cardId);
-      const assigneeId = args.assigneeId ? z.string().uuid().parse(args.assigneeId) : null;
-      const result = await client3.updateCard(cardId, { assigneeId });
+      if (args.assigneeId != null && args.agentId != null) {
+        throw new Error("Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both.");
+      }
+      const updates = {};
+      if (args.agentId !== undefined) {
+        updates.assignedAgentId = args.agentId ? z.string().uuid().parse(args.agentId) : null;
+      } else {
+        updates.assigneeId = args.assigneeId ? z.string().uuid().parse(args.assigneeId) : null;
+      }
+      const result = await client3.updateCard(cardId, updates);
       return { success: true, ...result };
     }
     case "harmony_search_cards": {
@@ -5479,6 +5498,11 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getWorkspaceMembers(workspaceId);
       return { success: true, ...result };
     }
+    case "harmony_list_agents": {
+      const workspaceId = getWorkspaceId();
+      const result = await client3.listWorkspaceAgents(workspaceId);
+      return { success: true, ...result };
+    }
     case "harmony_set_workspace_context": {
       const workspaceId = z.string().uuid().parse(args.workspaceId);
       deps.setActiveWorkspace(workspaceId);
@@ -7386,6 +7410,7 @@ var SAFE_HARMONY_TOOLS = [
   "harmony_list_plans",
   "harmony_get_agent_session",
   "harmony_get_workspace_members",
+  "harmony_list_agents",
   "harmony_resolve_links",
   "harmony_recall",
   "harmony_memory_search",

package/dist/index.js

@@ -1914,15 +1914,9 @@ class HarmonyApiClient {
   async endAgentSession(cardId, data) {
     return this.request("DELETE", `/cards/${cardId}/agent-context`, data);
   }
-  async flushActivityLog(cardId, data) {
-    return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
-  }
   async appendAgentRunEvents(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
   }
-  async getActivityLog(cardId, sessionId) {
-    return this.request("GET", `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`);
-  }
   async getPendingUserMessages(cardId, sessionId, sinceSeq) {
     return this.request("GET", `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`);
   }
@@ -3641,7 +3635,7 @@ var TOOLS = {
     }
   },
   harmony_assign_card: {
-    description: "Assign a card to a team member",
+    description: "Assign a card to a team member (human) or a virtual agent (e.g. the autonomous agent daemon). Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both. Use harmony_list_agents to find a virtual agent's id.",
     inputSchema: {
       type: "object",
       properties: {
@@ -3649,7 +3643,12 @@ var TOOLS = {
         assigneeId: {
           type: "string",
           nullable: true,
-          description: "User ID (null to unassign)"
+          description: "Human user ID (null to unassign). Mutually exclusive with agentId."
+        },
+        agentId: {
+          type: "string",
+          nullable: true,
+          description: "Virtual agent ID from harmony_list_agents (null to unassign). Setting it hands the card to the agent daemon. Mutually exclusive with assigneeId."
         }
       },
       required: ["cardId"]
@@ -4078,6 +4077,18 @@ var TOOLS = {
       }
     }
   },
+  harmony_list_agents: {
+    description: "List a workspace's virtual agents (autonomous agent daemons registered to the board). Returns each agent's id, identifier, name and last-seen time. Use the returned id with harmony_assign_card (agentId) to hand a card to the daemon.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspaceId: {
+          type: "string",
+          description: "Workspace ID (optional if context set)"
+        }
+      }
+    }
+  },
   harmony_set_workspace_context: {
     description: "Set the active workspace context for subsequent operations",
     inputSchema: {
@@ -5198,8 +5209,16 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_assign_card": {
       const cardId = z.string().uuid().parse(args.cardId);
-      const assigneeId = args.assigneeId ? z.string().uuid().parse(args.assigneeId) : null;
-      const result = await client3.updateCard(cardId, { assigneeId });
+      if (args.assigneeId != null && args.agentId != null) {
+        throw new Error("Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both.");
+      }
+      const updates = {};
+      if (args.agentId !== undefined) {
+        updates.assignedAgentId = args.agentId ? z.string().uuid().parse(args.agentId) : null;
+      } else {
+        updates.assigneeId = args.assigneeId ? z.string().uuid().parse(args.assigneeId) : null;
+      }
+      const result = await client3.updateCard(cardId, updates);
       return { success: true, ...result };
     }
     case "harmony_search_cards": {
@@ -5474,6 +5493,11 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getWorkspaceMembers(workspaceId);
       return { success: true, ...result };
     }
+    case "harmony_list_agents": {
+      const workspaceId = getWorkspaceId();
+      const result = await client3.listWorkspaceAgents(workspaceId);
+      return { success: true, ...result };
+    }
     case "harmony_set_workspace_context": {
       const workspaceId = z.string().uuid().parse(args.workspaceId);
       deps.setActiveWorkspace(workspaceId);

package/dist/lib/api-client.js

@@ -1367,15 +1367,9 @@ class HarmonyApiClient {
   async endAgentSession(cardId, data) {
     return this.request("DELETE", `/cards/${cardId}/agent-context`, data);
   }
-  async flushActivityLog(cardId, data) {
-    return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
-  }
   async appendAgentRunEvents(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
   }
-  async getActivityLog(cardId, sessionId) {
-    return this.request("GET", `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`);
-  }
   async getPendingUserMessages(cardId, sessionId, sinceSeq) {
     return this.request("GET", `/cards/${cardId}/agent-messages?sessionId=${sessionId}&sinceSeq=${sinceSeq}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.9.9",
+  "version": "2.11.0",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "publishConfig": {
     "access": "public"

package/src/api-client.ts

@@ -882,23 +882,6 @@ export class HarmonyApiClient {
     return this.request("DELETE", `/cards/${cardId}/agent-context`, data);
   }
 
-  async flushActivityLog(
-    cardId: string,
-    data: {
-      sessionId: string;
-      entries: {
-        phase?: string;
-        eventType: string;
-        toolName?: string;
-        description: string;
-        metadata?: Record<string, unknown>;
-        createdAt?: string;
-      }[];
-    },
-  ): Promise<{ inserted: number }> {
-    return this.request("POST", `/cards/${cardId}/agent-activity-log`, data);
-  }
-
   /**
    * Append events to a run's agent_run_events stream (card #417). Send drafts in
    * chronological order — the server's seq trigger assigns the monotonic per-run order.
@@ -913,26 +896,6 @@ export class HarmonyApiClient {
     return this.request("POST", `/cards/${cardId}/agent-run-events`, data);
   }
 
-  async getActivityLog(
-    cardId: string,
-    sessionId: string,
-  ): Promise<{
-    entries: {
-      id: string;
-      phase: string | null;
-      eventType: string;
-      toolName: string | null;
-      description: string;
-      metadata: Record<string, unknown>;
-      createdAt: string;
-    }[];
-  }> {
-    return this.request(
-      "GET",
-      `/cards/${cardId}/agent-activity-log?sessionId=${sessionId}`,
-    );
-  }
-
   /**
    * Drain queued chat-steering messages for a run (card #417). Returns `user_message`
    * events with `seq` greater than `sinceSeq`, oldest first, so the daemon can continue

package/src/server.ts

@@ -417,7 +417,8 @@ export const TOOLS = {
     },
   },
   harmony_assign_card: {
-    description: "Assign a card to a team member",
+    description:
+      "Assign a card to a team member (human) or a virtual agent (e.g. the autonomous agent daemon). Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both. Use harmony_list_agents to find a virtual agent's id.",
     inputSchema: {
       type: "object",
       properties: {
@@ -425,7 +426,14 @@ export const TOOLS = {
         assigneeId: {
           type: "string",
           nullable: true,
-          description: "User ID (null to unassign)",
+          description:
+            "Human user ID (null to unassign). Mutually exclusive with agentId.",
+        },
+        agentId: {
+          type: "string",
+          nullable: true,
+          description:
+            "Virtual agent ID from harmony_list_agents (null to unassign). Setting it hands the card to the agent daemon. Mutually exclusive with assigneeId.",
         },
       },
       required: ["cardId"],
@@ -894,6 +902,19 @@ export const TOOLS = {
       },
     },
   },
+  harmony_list_agents: {
+    description:
+      "List a workspace's virtual agents (autonomous agent daemons registered to the board). Returns each agent's id, identifier, name and last-seen time. Use the returned id with harmony_assign_card (agentId) to hand a card to the daemon.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspaceId: {
+          type: "string",
+          description: "Workspace ID (optional if context set)",
+        },
+      },
+    },
+  },
   harmony_set_workspace_context: {
     description: "Set the active workspace context for subsequent operations",
     inputSchema: {
@@ -2261,10 +2282,30 @@ async function handleToolCall(
 
     case "harmony_assign_card": {
       const cardId = z.string().uuid().parse(args.cardId);
-      const assigneeId = args.assigneeId
-        ? z.string().uuid().parse(args.assigneeId)
-        : null;
-      const result = await client.updateCard(cardId, { assigneeId });
+      if (args.assigneeId != null && args.agentId != null) {
+        throw new Error(
+          "Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both.",
+        );
+      }
+      // Send only the side being set. The MCP `agentId` arg maps to the
+      // backend's `assignedAgentId` field (DB column `assigned_agent_id`);
+      // `assigneeId` maps straight through. When one side is set to a non-null
+      // value the backend clears the other, so we never send both — that keeps
+      // a card from ending up assigned to a human AND an agent at once.
+      const updates: {
+        assigneeId?: string | null;
+        assignedAgentId?: string | null;
+      } = {};
+      if (args.agentId !== undefined) {
+        updates.assignedAgentId = args.agentId
+          ? z.string().uuid().parse(args.agentId)
+          : null;
+      } else {
+        updates.assigneeId = args.assigneeId
+          ? z.string().uuid().parse(args.assigneeId)
+          : null;
+      }
+      const result = await client.updateCard(cardId, updates);
       return { success: true, ...result };
     }
 
@@ -2652,6 +2693,12 @@ async function handleToolCall(
       return { success: true, ...result };
     }
 
+    case "harmony_list_agents": {
+      const workspaceId = getWorkspaceId();
+      const result = await client.listWorkspaceAgents(workspaceId);
+      return { success: true, ...result };
+    }
+
     case "harmony_set_workspace_context": {
       const workspaceId = z.string().uuid().parse(args.workspaceId);
       deps.setActiveWorkspace(workspaceId);

package/src/tui/setup.ts

@@ -74,6 +74,7 @@ const SAFE_HARMONY_TOOLS = [
   "harmony_list_plans",
   "harmony_get_agent_session",
   "harmony_get_workspace_members",
+  "harmony_list_agents",
   "harmony_resolve_links",
   "harmony_recall",
   "harmony_memory_search",