@gethmy/mcp 2.10.0 → 2.11.1

package/dist/cli.js

@@ -1913,6 +1913,12 @@ class HarmonyApiClient {
   async startAgentSession(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
+  async getPendingMessages(cardId, sessionId, sinceSeq) {
+    const params = new URLSearchParams;
+    params.set("sessionId", sessionId);
+    params.set("sinceSeq", String(sinceSeq));
+    return this.request("GET", `/cards/${cardId}/agent-messages?${params.toString()}`);
+  }
   async updateAgentProgress(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
@@ -4172,6 +4178,10 @@ var TOOLS = {
           type: "array",
           items: { type: "string" },
           description: 'Label names to add to card (e.g., ["agent"]). Case-insensitive match.'
+        },
+        steerable: {
+          type: "boolean",
+          description: "Set true only if this session will poll harmony_get_pending_messages at its checkpoints. Enables the live steering composer for the run; leave unset/false if you won't consume steering messages."
         }
       },
       required: ["cardId", "agentIdentifier", "agentName"]
@@ -4262,6 +4272,27 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_get_pending_messages: {
+    description: "Drain queued steering messages a teammate sent to your live agent session (card #473). Call at your progress checkpoints with the session id from harmony_start_agent_session and the highest seq you've already consumed; returns user messages with seq > sinceSeq, oldest first. Fold them into your next step and advance sinceSeq to the largest returned seq so each is handled exactly once.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card ID with the live session"
+        },
+        sessionId: {
+          type: "string",
+          description: "Agent session id (the `session.id` returned by harmony_start_agent_session)"
+        },
+        sinceSeq: {
+          type: "number",
+          description: "Return only messages with seq greater than this (the last seq you consumed). Defaults to 0 to fetch all."
+        }
+      },
+      required: ["cardId", "sessionId"]
+    }
+  },
   harmony_generate_prompt: {
     description: "Generate an AI-ready prompt from a card. Automatically infers role and focus based on labels (bug, feature, design, etc.). Use this to create context-rich prompts for working on cards.",
     inputSchema: {
@@ -5597,7 +5628,8 @@ async function handleToolCall(name, args, deps) {
         agentName,
         status: "working",
         currentTask: args.currentTask,
-        estimatedMinutesRemaining: args.estimatedMinutesRemaining
+        estimatedMinutesRemaining: args.estimatedMinutesRemaining,
+        steerable: args.steerable === true || args.steerable === "true" ? true : undefined
       });
       markExplicit(cardId, {
         agentIdentifier,
@@ -5636,6 +5668,7 @@ async function handleToolCall(name, args, deps) {
       } else if (callerRecentActions.length > 0) {
         mergedRecentActions = callerRecentActions;
       }
+      const runActivity = (callerActions || []).map((a) => a.description).filter((d) => typeof d === "string" && d.length > 0);
       const result = await client3.updateAgentProgress(cardId, {
         agentIdentifier,
         agentName,
@@ -5644,7 +5677,8 @@ async function handleToolCall(name, args, deps) {
         currentTask: args.currentTask,
         blockers: args.blockers,
         estimatedMinutesRemaining: args.estimatedMinutesRemaining,
-        ...mergedRecentActions && { recentActions: mergedRecentActions }
+        ...mergedRecentActions && { recentActions: mergedRecentActions },
+        ...runActivity.length > 0 && { runActivity }
       });
       return { success: true, midSessionLearnings: 0, ...result };
     }
@@ -5700,6 +5734,13 @@ async function handleToolCall(name, args, deps) {
       });
       return { success: true, ...result };
     }
+    case "harmony_get_pending_messages": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const sessionId = z.string().min(1).parse(args.sessionId);
+      const sinceSeq = args.sinceSeq !== undefined ? z.number().int().min(0).parse(args.sinceSeq) : 0;
+      const result = await client3.getPendingMessages(cardId, sessionId, sinceSeq);
+      return { success: true, ...result };
+    }
     case "harmony_generate_prompt": {
       let cardId;
       if (args.cardId) {

package/dist/index.js

@@ -1908,6 +1908,12 @@ class HarmonyApiClient {
   async startAgentSession(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
+  async getPendingMessages(cardId, sessionId, sinceSeq) {
+    const params = new URLSearchParams;
+    params.set("sessionId", sessionId);
+    params.set("sinceSeq", String(sinceSeq));
+    return this.request("GET", `/cards/${cardId}/agent-messages?${params.toString()}`);
+  }
   async updateAgentProgress(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
@@ -4167,6 +4173,10 @@ var TOOLS = {
           type: "array",
           items: { type: "string" },
           description: 'Label names to add to card (e.g., ["agent"]). Case-insensitive match.'
+        },
+        steerable: {
+          type: "boolean",
+          description: "Set true only if this session will poll harmony_get_pending_messages at its checkpoints. Enables the live steering composer for the run; leave unset/false if you won't consume steering messages."
         }
       },
       required: ["cardId", "agentIdentifier", "agentName"]
@@ -4257,6 +4267,27 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_get_pending_messages: {
+    description: "Drain queued steering messages a teammate sent to your live agent session (card #473). Call at your progress checkpoints with the session id from harmony_start_agent_session and the highest seq you've already consumed; returns user messages with seq > sinceSeq, oldest first. Fold them into your next step and advance sinceSeq to the largest returned seq so each is handled exactly once.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card ID with the live session"
+        },
+        sessionId: {
+          type: "string",
+          description: "Agent session id (the `session.id` returned by harmony_start_agent_session)"
+        },
+        sinceSeq: {
+          type: "number",
+          description: "Return only messages with seq greater than this (the last seq you consumed). Defaults to 0 to fetch all."
+        }
+      },
+      required: ["cardId", "sessionId"]
+    }
+  },
   harmony_generate_prompt: {
     description: "Generate an AI-ready prompt from a card. Automatically infers role and focus based on labels (bug, feature, design, etc.). Use this to create context-rich prompts for working on cards.",
     inputSchema: {
@@ -5592,7 +5623,8 @@ async function handleToolCall(name, args, deps) {
         agentName,
         status: "working",
         currentTask: args.currentTask,
-        estimatedMinutesRemaining: args.estimatedMinutesRemaining
+        estimatedMinutesRemaining: args.estimatedMinutesRemaining,
+        steerable: args.steerable === true || args.steerable === "true" ? true : undefined
       });
       markExplicit(cardId, {
         agentIdentifier,
@@ -5631,6 +5663,7 @@ async function handleToolCall(name, args, deps) {
       } else if (callerRecentActions.length > 0) {
         mergedRecentActions = callerRecentActions;
       }
+      const runActivity = (callerActions || []).map((a) => a.description).filter((d) => typeof d === "string" && d.length > 0);
       const result = await client3.updateAgentProgress(cardId, {
         agentIdentifier,
         agentName,
@@ -5639,7 +5672,8 @@ async function handleToolCall(name, args, deps) {
         currentTask: args.currentTask,
         blockers: args.blockers,
         estimatedMinutesRemaining: args.estimatedMinutesRemaining,
-        ...mergedRecentActions && { recentActions: mergedRecentActions }
+        ...mergedRecentActions && { recentActions: mergedRecentActions },
+        ...runActivity.length > 0 && { runActivity }
       });
       return { success: true, midSessionLearnings: 0, ...result };
     }
@@ -5695,6 +5729,13 @@ async function handleToolCall(name, args, deps) {
       });
       return { success: true, ...result };
     }
+    case "harmony_get_pending_messages": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const sessionId = z.string().min(1).parse(args.sessionId);
+      const sinceSeq = args.sinceSeq !== undefined ? z.number().int().min(0).parse(args.sinceSeq) : 0;
+      const result = await client3.getPendingMessages(cardId, sessionId, sinceSeq);
+      return { success: true, ...result };
+    }
     case "harmony_generate_prompt": {
       let cardId;
       if (args.cardId) {

package/dist/lib/api-client.js

@@ -1361,6 +1361,12 @@ class HarmonyApiClient {
   async startAgentSession(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
+  async getPendingMessages(cardId, sessionId, sinceSeq) {
+    const params = new URLSearchParams;
+    params.set("sessionId", sessionId);
+    params.set("sinceSeq", String(sinceSeq));
+    return this.request("GET", `/cards/${cardId}/agent-messages?${params.toString()}`);
+  }
   async updateAgentProgress(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }

package/package.json

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

package/src/api-client.ts

@@ -792,6 +792,8 @@ export class HarmonyApiClient {
       agentIdentifier: string;
       agentName: string;
       agentId?: string | null;
+      /** Advertise that this session polls for queued steering messages (card #473). */
+      steerable?: boolean;
       status?: "working" | "blocked" | "paused" | "completed";
       progressPercent?: number;
       currentTask?: string;
@@ -802,6 +804,26 @@ export class HarmonyApiClient {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
 
+  /**
+   * Drain queued `user_message` steering events for a session (card #473).
+   * Wraps the existing `GET /cards/{id}/agent-messages` endpoint that the daemon
+   * already polls — exposed so MCP/human sessions (e.g. /hmy) can consume steering
+   * at their checkpoints. Returns messages with `seq > sinceSeq`, oldest first.
+   */
+  async getPendingMessages(
+    cardId: string,
+    sessionId: string,
+    sinceSeq: number,
+  ): Promise<{ messages: unknown[] }> {
+    const params = new URLSearchParams();
+    params.set("sessionId", sessionId);
+    params.set("sinceSeq", String(sinceSeq));
+    return this.request(
+      "GET",
+      `/cards/${cardId}/agent-messages?${params.toString()}`,
+    );
+  }
+
   async updateAgentProgress(
     cardId: string,
     data: {
@@ -828,6 +850,8 @@ export class HarmonyApiClient {
       modelName?: string;
       numTurns?: number;
       recentActions?: { action: string; ts: string }[];
+      /** Per-call activity descriptions → one assistant_text timeline event each (card #470). */
+      runActivity?: string[];
       failureReason?:
         | "verification"
         | "review"

package/src/server.ts

@@ -1002,6 +1002,11 @@ export const TOOLS = {
           description:
             'Label names to add to card (e.g., ["agent"]). Case-insensitive match.',
         },
+        steerable: {
+          type: "boolean",
+          description:
+            "Set true only if this session will poll harmony_get_pending_messages at its checkpoints. Enables the live steering composer for the run; leave unset/false if you won't consume steering messages.",
+        },
       },
       required: ["cardId", "agentIdentifier", "agentName"],
     },
@@ -1097,6 +1102,30 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_get_pending_messages: {
+    description:
+      "Drain queued steering messages a teammate sent to your live agent session (card #473). Call at your progress checkpoints with the session id from harmony_start_agent_session and the highest seq you've already consumed; returns user messages with seq > sinceSeq, oldest first. Fold them into your next step and advance sinceSeq to the largest returned seq so each is handled exactly once.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card ID with the live session",
+        },
+        sessionId: {
+          type: "string",
+          description:
+            "Agent session id (the `session.id` returned by harmony_start_agent_session)",
+        },
+        sinceSeq: {
+          type: "number",
+          description:
+            "Return only messages with seq greater than this (the last seq you consumed). Defaults to 0 to fetch all.",
+        },
+      },
+      required: ["cardId", "sessionId"],
+    },
+  },
 
   // Prompt generation
   harmony_generate_prompt: {
@@ -2287,7 +2316,11 @@ async function handleToolCall(
           "Pass at most one of assigneeId / agentId — a card is assigned to a human OR an agent, never both.",
         );
       }
-      // The backend nulls the opposite field, so only send the side being set.
+      // 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;
@@ -2832,6 +2865,10 @@ async function handleToolCall(
         estimatedMinutesRemaining: args.estimatedMinutesRemaining as
           | number
           | undefined,
+        steerable:
+          args.steerable === true || args.steerable === "true"
+            ? true
+            : undefined,
       });
 
       // Mark as explicit so auto-session won't interfere
@@ -2892,6 +2929,13 @@ async function handleToolCall(
         mergedRecentActions = callerRecentActions;
       }
 
+      // Per-call deltas for the run timeline. Sourced from THIS call's `actions`
+      // only (not the cumulative `recentActions` cache), so each lands as exactly
+      // one assistant_text event without duplication. (card #470)
+      const runActivity = (callerActions || [])
+        .map((a) => a.description)
+        .filter((d): d is string => typeof d === "string" && d.length > 0);
+
       const result = await client.updateAgentProgress(cardId, {
         agentIdentifier,
         agentName,
@@ -2908,6 +2952,7 @@ async function handleToolCall(
           | number
           | undefined,
         ...(mergedRecentActions && { recentActions: mergedRecentActions }),
+        ...(runActivity.length > 0 && { runActivity }),
       });
 
       // Phase 0 (memory architecture v2): mid-session learning extraction removed.
@@ -3004,6 +3049,21 @@ async function handleToolCall(
       return { success: true, ...result };
     }
 
+    case "harmony_get_pending_messages": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const sessionId = z.string().min(1).parse(args.sessionId);
+      const sinceSeq =
+        args.sinceSeq !== undefined
+          ? z.number().int().min(0).parse(args.sinceSeq)
+          : 0;
+      const result = await client.getPendingMessages(
+        cardId,
+        sessionId,
+        sinceSeq,
+      );
+      return { success: true, ...result };
+    }
+
     // Prompt generation
     // TODO Phase 1: rebuild full context assembly per docs/superpowers/plans/2026-05-07-memory-architecture-v2.md §10
     case "harmony_generate_prompt": {