@gethmy/mcp 2.25.0 → 2.26.0

package/dist/cli.js

@@ -1520,6 +1520,9 @@ function declaredGateMetricsFromAgents(agents) {
   }
   return { names, known };
 }
+// ../harmony-shared/dist/fanoutSource.js
+var FANOUT_KEY_MARKER = "harmony:fanout-item";
+var FANOUT_KEY_RE = new RegExp(`^\\[${FANOUT_KEY_MARKER}\\]:\\s*#(\\S+)\\s*$`, "m");
 // ../harmony-shared/dist/gateConfigError.js
 var GATE_CONFIG_ERROR_KEY = "configError";
 var GATE_CONFIG_ERROR_MARK = Object.freeze({ [GATE_CONFIG_ERROR_KEY]: true });
@@ -1947,8 +1950,12 @@ class HarmonyApiClient {
   async updateCard(cardId, updates) {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
-  async claimCard(cardId, agentId) {
-    const res = await this.request("PATCH", `/cards/${cardId}`, { assignedAgentId: agentId, ifAssignedAgentNull: true });
+  async claimCard(cardId, agentId, opts) {
+    const res = await this.request("PATCH", `/cards/${cardId}`, {
+      assignedAgentId: agentId,
+      ifAssignedAgentNull: true,
+      ...opts?.requireUnassigned ? { ifAssigneeNull: true } : {}
+    });
     return { claimed: res.claimed !== false };
   }
   async moveCard(cardId, columnId, position) {

package/dist/index.js

@@ -1515,6 +1515,9 @@ function declaredGateMetricsFromAgents(agents) {
   }
   return { names, known };
 }
+// ../harmony-shared/dist/fanoutSource.js
+var FANOUT_KEY_MARKER = "harmony:fanout-item";
+var FANOUT_KEY_RE = new RegExp(`^\\[${FANOUT_KEY_MARKER}\\]:\\s*#(\\S+)\\s*$`, "m");
 // ../harmony-shared/dist/gateConfigError.js
 var GATE_CONFIG_ERROR_KEY = "configError";
 var GATE_CONFIG_ERROR_MARK = Object.freeze({ [GATE_CONFIG_ERROR_KEY]: true });
@@ -1942,8 +1945,12 @@ class HarmonyApiClient {
   async updateCard(cardId, updates) {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
-  async claimCard(cardId, agentId) {
-    const res = await this.request("PATCH", `/cards/${cardId}`, { assignedAgentId: agentId, ifAssignedAgentNull: true });
+  async claimCard(cardId, agentId, opts) {
+    const res = await this.request("PATCH", `/cards/${cardId}`, {
+      assignedAgentId: agentId,
+      ifAssignedAgentNull: true,
+      ...opts?.requireUnassigned ? { ifAssigneeNull: true } : {}
+    });
     return { claimed: res.claimed !== false };
   }
   async moveCard(cardId, columnId, position) {

package/dist/lib/api-client.js

@@ -951,6 +951,9 @@ var TIMINGS = {
   QUERY_STALE_TIME: 1000 * 60 * 5,
   QUERY_GC_TIME: 1000 * 60 * 60 * 24
 };
+// ../harmony-shared/dist/fanoutSource.js
+var FANOUT_KEY_MARKER = "harmony:fanout-item";
+var FANOUT_KEY_RE = new RegExp(`^\\[${FANOUT_KEY_MARKER}\\]:\\s*#(\\S+)\\s*$`, "m");
 // ../harmony-shared/dist/gateConfigError.js
 var GATE_CONFIG_ERROR_KEY = "configError";
 var GATE_CONFIG_ERROR_MARK = Object.freeze({ [GATE_CONFIG_ERROR_KEY]: true });
@@ -1312,8 +1315,12 @@ class HarmonyApiClient {
   async updateCard(cardId, updates) {
     return this.request("PATCH", `/cards/${cardId}`, updates);
   }
-  async claimCard(cardId, agentId) {
-    const res = await this.request("PATCH", `/cards/${cardId}`, { assignedAgentId: agentId, ifAssignedAgentNull: true });
+  async claimCard(cardId, agentId, opts) {
+    const res = await this.request("PATCH", `/cards/${cardId}`, {
+      assignedAgentId: agentId,
+      ifAssignedAgentNull: true,
+      ...opts?.requireUnassigned ? { ifAssigneeNull: true } : {}
+    });
     return { claimed: res.claimed !== false };
   }
   async moveCard(cardId, columnId, position) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.25.0",
+  "version": "2.26.0",
   "description": "MCP server for Harmony, the shared surface for human–agent teams — agents claim cards, report progress, and move work on your board.",
   "publishConfig": {
     "access": "public"

package/src/api-client.ts

@@ -724,15 +724,27 @@ export class HarmonyApiClient {
    * Compare-and-set claim of a card for a virtual agent: sets assigned_agent_id
    * only if it is currently NULL (server-side guard). Returns `{ claimed: false }`
    * when another daemon already owns it. Used by the agent-agnostic review pickup.
+   *
+   * `requireUnassigned` additionally guards `assignee_id IS NULL`, so the claim
+   * also loses to a PERSON who took the card. Self-selection (sweep, card #978)
+   * needs it: this write clears `assignee_id` as a side effect, so the agent-only
+   * guard does not merely let the daemon co-own a person's card — it lets the
+   * daemon erase their assignment. Default false keeps the review-strand claim
+   * (which reaches only cards no one holds) byte-unchanged.
    */
   async claimCard(
     cardId: string,
     agentId: string,
+    opts?: { requireUnassigned?: boolean },
   ): Promise<{ claimed: boolean }> {
     const res = await this.request<{ card?: unknown; claimed?: boolean }>(
       "PATCH",
       `/cards/${cardId}`,
-      { assignedAgentId: agentId, ifAssignedAgentNull: true },
+      {
+        assignedAgentId: agentId,
+        ifAssignedAgentNull: true,
+        ...(opts?.requireUnassigned ? { ifAssigneeNull: true } : {}),
+      },
     );
     // Success body is `{ card }` (no `claimed` key) → won. Lost-race body is
     // `{ claimed: false }`.