@gethmy/mcp 2.2.1 → 2.2.3

package/dist/http.js

@@ -26,6 +26,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/http.ts
@@ -1637,7 +1638,7 @@ var cors = (options) => {
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
-var DEFAULT_API_URL = "https://gethmy.com/api";
+var DEFAULT_API_URL = "https://app.gethmy.com/api";
 var LOCAL_CONFIG_FILENAME = ".harmony-mcp.json";
 function getConfigDir() {
   return join(homedir(), ".harmony-mcp");
@@ -1730,7 +1731,7 @@ function hasLocalConfig(cwd) {
 function getApiKey() {
   const config = loadConfig();
   if (!config.apiKey) {
-    throw new Error(`Not configured. Run "harmony-mcp configure" to set your API key.
+    throw new Error(`Not configured. Run "npx @gethmy/mcp setup" to set your API key.
 ` + "You can generate an API key at https://gethmy.com \u2192 Settings \u2192 API Keys.");
   }
   return config.apiKey;
@@ -1823,6 +1824,7 @@ var app = new Hono2;
 app.use("/*", cors({
   origin: [
     "https://gethmy.com",
+    "https://app.gethmy.com",
     "http://localhost:8080",
     "http://localhost:3000"
   ],
@@ -1841,7 +1843,7 @@ async function forwardToApi(method, path, authHeader, apiKey, body) {
   if (apiKey) {
     headers["X-API-Key"] = apiKey;
   } else if (authHeader) {
-    headers["Authorization"] = authHeader;
+    headers.Authorization = authHeader;
   } else {
     throw new Error("Unauthorized: Missing API key or Authorization header");
   }
@@ -1899,7 +1901,7 @@ async function handleRequest(c, method, path) {
   try {
     const authHeader = c.req.header("Authorization");
     const apiKey = c.req.header("X-API-Key");
-    let body = undefined;
+    let body;
     if (["POST", "PATCH", "PUT"].includes(method)) {
       try {
         body = await c.json();

package/dist/index.js

@@ -29,19 +29,19 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// ../memory/src/schema.ts
+// ../memory/dist/schema.js
 var init_schema = () => {};
 
-// ../memory/src/constraints.ts
+// ../memory/dist/constraints.js
 var init_constraints = __esm(() => {
   init_schema();
 });
-// ../memory/src/client.ts
+// ../memory/dist/client.js
 var init_client = __esm(() => {
   init_constraints();
 });
 
-// ../memory/src/graph-walk.ts
+// ../memory/dist/graph-walk.js
 async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
   const visited = new Set;
   const collectedEntities = [];
@@ -122,7 +122,7 @@ async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntitie
   };
 }
 
-// ../memory/src/lifecycle.ts
+// ../memory/dist/lifecycle.js
 function computeDecayScore(tier, lastAccessedAt, accessCount) {
   const halfLife = DECAY_HALF_LIVES[tier];
   const now = Date.now();
@@ -207,7 +207,7 @@ var init_lifecycle = __esm(() => {
   };
 });
 
-// ../memory/src/sync-storage.ts
+// ../memory/dist/sync-storage.js
 function parseSyncMarkdown(markdown) {
   const trimmed = markdown.trim();
   let frontmatter = {
@@ -323,16 +323,9 @@ function parseYamlArray(value) {
   return match[1].split(",").map((s) => s.trim()).filter(Boolean);
 }
 
-// ../memory/src/sync.ts
+// ../memory/dist/sync.js
 import { createHash } from "node:crypto";
-import {
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  rmSync,
-  writeFileSync
-} from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 function computeFileHash(content) {
   return `sha256:${createHash("sha256").update(content).digest("hex")}`;
@@ -597,8 +590,8 @@ async function syncFull(client, config, workspaceId, projectId) {
 }
 var init_sync = () => {};
 
-// ../memory/src/index.ts
-var init_src = __esm(() => {
+// ../memory/dist/index.js
+var init_dist = __esm(() => {
   init_client();
   init_constraints();
   init_lifecycle();
@@ -7562,7 +7555,7 @@ async function recordContextFeedback(client2, cardId, sessionStatus, progressPer
 }
 var DEFAULT_TOKEN_BUDGET = 4000, MAX_TOKENS_PER_ENTITY = 500, MIN_RELEVANCE_THRESHOLD = 0.1, TIER_WEIGHTS, PROCEDURE_BUDGET_FRACTION = 0.15, TIER_BUDGET_ALLOCATION, MIN_REFERENCE_SLOTS = 3, manifestCache, MAX_CACHE_SIZE = 50, sessionAssemblyMap, MAX_SESSION_MAP_SIZE = 100;
 var init_context_assembly = __esm(() => {
-  init_src();
+  init_dist();
   TIER_WEIGHTS = {
     reference: 1,
     episode: 0.7,
@@ -8017,7 +8010,7 @@ var init_prompt_builder = __esm(() => {
 });
 
 // src/server.ts
-init_src();
+init_dist();
 
 // ../../node_modules/zod/v4/core/index.js
 var exports_core2 = {};
@@ -25789,7 +25782,7 @@ function deriveClusterTitle(cluster, type) {
 init_context_assembly();
 
 // src/lifecycle-maintenance.ts
-init_src();
+init_dist();
 async function runLifecycleMaintenance(client3, workspaceId, projectId) {
   const result = {
     archived: 0,
@@ -25858,6 +25851,47 @@ async function runLifecycleMaintenance(client3, workspaceId, projectId) {
   return result;
 }
 
+// src/onboard.ts
+async function onboardNewUser(params) {
+  const {
+    email: email3,
+    password,
+    fullName,
+    workspaceName = `${fullName}'s Workspace`,
+    projectName = "My First Board",
+    template = "kanban",
+    keyName = "mcp-agent",
+    apiUrl = getApiUrl()
+  } = params;
+  const signupResult = await signupUser(apiUrl, {
+    email: email3,
+    password,
+    full_name: fullName
+  });
+  const token = signupResult.session.access_token;
+  const workspaceResult = await requestWithBearer(apiUrl, token, "POST", "/workspaces", {
+    name: workspaceName
+  });
+  const projectResult = await requestWithBearer(apiUrl, token, "POST", "/projects", {
+    workspaceId: workspaceResult.workspace.id,
+    name: projectName,
+    template
+  });
+  const keyResult = await requestWithBearer(apiUrl, token, "POST", "/api-keys", {
+    name: keyName
+  });
+  return {
+    user: signupResult.user,
+    workspace: workspaceResult.workspace,
+    project: projectResult.project,
+    columns: projectResult.columns,
+    apiKey: {
+      rawKey: keyResult.rawKey,
+      prefix: keyResult.apiKey.prefix
+    }
+  };
+}
+
 // src/server.ts
 var memorySessions = new Map;
 function initMemorySession(cardId, agentIdentifier, agentName) {
@@ -25992,18 +26026,22 @@ var TOOLS = {
     }
   },
   harmony_move_card: {
-    description: "Move a card to a different column or position",
+    description: "Move a card to a different column or position. Provide either columnId (UUID) or columnName (e.g. 'Review', 'Done').",
     inputSchema: {
       type: "object",
       properties: {
         cardId: { type: "string", description: "Card ID to move" },
-        columnId: { type: "string", description: "Target column ID" },
+        columnId: { type: "string", description: "Target column ID (UUID)" },
+        columnName: {
+          type: "string",
+          description: "Target column name (e.g. 'To Do', 'In Progress', 'Review', 'Done'). Used if columnId is not provided."
+        },
         position: {
           type: "number",
           description: "Position in column (0-indexed)"
         }
       },
-      required: ["cardId", "columnId"]
+      required: ["cardId"]
     }
   },
   harmony_archive_card: {
@@ -26134,14 +26172,21 @@ var TOOLS = {
     }
   },
   harmony_add_label_to_card: {
-    description: "Add a label to a card",
+    description: "Add a label to a card. Provide labelId directly, or labelName to look up (or auto-create) the label by name.",
     inputSchema: {
       type: "object",
       properties: {
         cardId: { type: "string" },
-        labelId: { type: "string" }
+        labelId: {
+          type: "string",
+          description: "Label ID (optional if labelName provided)"
+        },
+        labelName: {
+          type: "string",
+          description: "Label name — will look up or create if not found"
+        }
       },
-      required: ["cardId", "labelId"]
+      required: ["cardId"]
     }
   },
   harmony_remove_label_from_card: {
@@ -27458,6 +27503,17 @@ function registerHandlers(server, deps) {
     throw new Error(`Unknown resource: ${uri}`);
   });
 }
+async function resolveColumnByName(client3, projectId, columnName) {
+  const board = await client3.getBoard(projectId, { summary: true });
+  const columns = board.columns;
+  const lower = columnName.toLowerCase();
+  const col = columns.find((c) => c.name.toLowerCase() === lower) || columns.find((c) => c.name.toLowerCase().includes(lower));
+  if (!col) {
+    const available = columns.map((c) => c.name).join(", ");
+    throw new Error(`Column "${columnName}" not found. Available columns: ${available}`);
+  }
+  return col;
+}
 async function handleToolCall(name, args, deps) {
   const unauthenticatedTools = ["harmony_signup", "harmony_onboard"];
   if (!unauthenticatedTools.includes(name) && !deps.isConfigured()) {
@@ -27507,16 +27563,29 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_move_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
-      const columnId = exports_external.string().uuid().parse(args.columnId);
       const position = args.position !== undefined ? exports_external.number().int().min(0).parse(args.position) : undefined;
+      let columnId;
+      let resolvedProjectId;
+      if (args.columnId) {
+        columnId = exports_external.string().uuid().parse(args.columnId);
+      } else if (args.columnName) {
+        const columnName = exports_external.string().parse(args.columnName);
+        const { card: cardForProject } = await client3.getCard(cardId);
+        resolvedProjectId = cardForProject?.project_id;
+        if (!resolvedProjectId)
+          throw new Error("Card has no project");
+        const col = await resolveColumnByName(client3, resolvedProjectId, columnName);
+        columnId = col.id;
+      } else {
+        throw new Error("Either columnId or columnName is required");
+      }
       const result = await client3.moveCard(cardId, columnId, position);
       let sessionEnded = false;
       try {
         const { card } = result;
-        if (card?.project_id) {
-          const board = await client3.getBoard(card.project_id, {
-            summary: true
-          });
+        const projectId = card?.project_id || resolvedProjectId;
+        if (projectId) {
+          const board = await client3.getBoard(projectId, { summary: true });
           const columns = board.columns;
           const destCol = columns.find((c) => c.id === columnId);
           const colName = destCol?.name?.toLowerCase() || "";
@@ -27603,7 +27672,32 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_add_label_to_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
-      const labelId = exports_external.string().uuid().parse(args.labelId);
+      let labelId = args.labelId ? exports_external.string().uuid().parse(args.labelId) : undefined;
+      const labelName = args.labelName ? exports_external.string().min(1).max(100).parse(args.labelName) : undefined;
+      if (!labelId && labelName) {
+        const { card } = await client3.getCard(cardId);
+        const projectId = card.project_id;
+        if (!projectId) {
+          throw new Error("Cannot resolve label by name: card has no project_id");
+        }
+        if (projectId) {
+          const board = await client3.getBoard(projectId, { summary: true });
+          const labels = board.labels;
+          const existing = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+          if (existing) {
+            labelId = existing.id;
+          } else {
+            const created = await client3.createLabel(projectId, {
+              name: labelName,
+              color: "#57b8a5"
+            });
+            labelId = created.label.id;
+          }
+        }
+      }
+      if (!labelId) {
+        throw new Error("Either labelId or labelName must be provided");
+      }
       await client3.addLabelToCard(cardId, labelId);
       return { success: true };
     }
@@ -27733,10 +27827,17 @@ async function handleToolCall(name, args, deps) {
             }
             if (addLabels?.length) {
               for (const labelName of addLabels) {
-                const label = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                let label = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                if (!label && projectId) {
+                  const created = await client3.createLabel(projectId, {
+                    name: labelName,
+                    color: "#57b8a5"
+                  });
+                  label = created.label;
+                }
                 if (label) {
                   await client3.addLabelToCard(cardId, label.id);
-                  labelsAdded.push(label.name);
+                  labelsAdded.push(label.name ?? labelName);
                 }
               }
             }
@@ -27856,27 +27957,21 @@ async function handleToolCall(name, args, deps) {
       const endProgressPercent = args.progressPercent !== undefined ? exports_external.number().min(0).max(100).parse(args.progressPercent) : undefined;
       await flushMemoryActions(client3, cardId);
       cleanupMemorySession(cardId);
-      const result = await client3.endAgentSession(cardId, {
-        status: sessionStatus,
-        progressPercent: endProgressPercent
-      });
+      let result = { session: null };
+      let sessionEndError = null;
+      try {
+        result = await client3.endAgentSession(cardId, {
+          status: sessionStatus,
+          progressPercent: endProgressPercent
+        });
+      } catch (err) {
+        sessionEndError = err instanceof Error ? err.message : "Failed to end session";
+      }
       untrack(cardId);
       let movedTo = null;
-      const _learningsExtracted = 0;
-      let _cardTitle = "";
-      let _cardLabels = [];
-      let _cardDescription = "";
-      let _cardSubtasks = [];
       try {
         const { card } = await client3.getCard(cardId);
         const typedCard = card;
-        _cardTitle = typedCard.title || "";
-        _cardLabels = (typedCard.labels || []).map((l) => l.name);
-        _cardDescription = typedCard.description || "";
-        _cardSubtasks = (typedCard.subtasks || []).map((s) => ({
-          title: s.title,
-          done: s.done
-        }));
         const projectId = typedCard.project_id;
         if (sessionStatus === "completed" && typedCard.labels?.length) {
           const agentLabel = typedCard.labels.find((l) => l.name.toLowerCase() === "agent");
@@ -27885,21 +27980,16 @@ async function handleToolCall(name, args, deps) {
           }
         }
         if (moveToColumn && projectId) {
-          const board = await client3.getBoard(projectId, {
-            summary: true
-          });
-          const columns = board.columns;
-          const col = columns.find((c) => c.name.toLowerCase().includes(moveToColumn.toLowerCase()));
-          if (col) {
-            await client3.moveCard(cardId, col.id);
-            movedTo = col.name;
-          }
+          const col = await resolveColumnByName(client3, projectId, moveToColumn);
+          await client3.moveCard(cardId, col.id);
+          movedTo = col.name;
         }
       } catch {}
       const sessionObj = result.session;
       const pipelineResult = await runEndSessionPipeline(client3, deps, cardId, sessionStatus, endProgressPercent, sessionObj);
       return {
         success: true,
+        ...sessionEndError && { sessionEndError },
         movedTo,
         learningsExtracted: pipelineResult.learningsExtracted,
         feedbackAdjusted: pipelineResult.feedbackAdjusted,
@@ -28641,38 +28731,27 @@ async function handleToolCall(name, args, deps) {
       const projectName = args.projectName || "My First Project";
       const template = args.template || "kanban";
       const keyName = args.keyName || "mcp-agent";
-      const apiUrl = deps.getApiUrl();
-      const signupResult = await signupUser(apiUrl, {
+      const result = await onboardNewUser({
         email: email3,
         password,
-        full_name: fullName
-      });
-      const token = signupResult.session.access_token;
-      const workspaceResult = await requestWithBearer(apiUrl, token, "POST", "/workspaces", {
-        name: workspaceName
+        fullName,
+        workspaceName,
+        projectName,
+        template,
+        keyName,
+        apiUrl: deps.getApiUrl()
       });
-      const projectResult = await requestWithBearer(apiUrl, token, "POST", "/projects", {
-        workspaceId: workspaceResult.workspace.id,
-        name: projectName,
-        template
-      });
-      const keyResult = await requestWithBearer(apiUrl, token, "POST", "/api-keys", {
-        name: keyName
-      });
-      deps.saveConfig({ apiKey: keyResult.rawKey });
-      deps.setActiveWorkspace(workspaceResult.workspace.id);
-      deps.setActiveProject(projectResult.project.id);
+      deps.saveConfig({ apiKey: result.apiKey.rawKey });
+      deps.setActiveWorkspace(result.workspace.id);
+      deps.setActiveProject(result.project.id);
       deps.resetClient();
       return {
         success: true,
-        user: signupResult.user,
-        workspace: workspaceResult.workspace,
-        project: projectResult.project,
-        columns: projectResult.columns,
-        apiKey: {
-          rawKey: keyResult.rawKey,
-          prefix: keyResult.apiKey.prefix
-        },
+        user: result.user,
+        workspace: result.workspace,
+        project: result.project,
+        columns: result.columns,
+        apiKey: result.apiKey,
         message: `Onboarding complete! Account created for ${email3}. Workspace "${workspaceName}" and project "${projectName}" are ready. API key saved to config.`
       };
     }

package/dist/lib/auto-session.js

@@ -6,7 +6,7 @@
  * after 10 minutes of inactivity or when a different card is worked on.
  *
  * Agent identity is resolved from the MCP client's `initialize` handshake
- * (clientInfo.name), so "Claude Code", "Cursor", "Windsurf", etc. are
+ * (clientInfo.name), so "Claude Code", "Cursor", "Codex", etc. are
  * detected automatically — no hardcoded fallback needed.
  */
 /** Well-known MCP client names → human-friendly display names */

package/dist/lib/cli.js

@@ -15,6 +15,11 @@ program
     .command("serve")
     .description("Start the MCP server (stdio transport)")
     .action(async () => {
+    if (!isConfigured()) {
+        console.error("No API key configured.");
+        console.error("Run: npx @gethmy/mcp setup");
+        process.exit(1);
+    }
     await refreshSkills();
     const server = new HarmonyMCPServer();
     await server.run();
@@ -109,6 +114,8 @@ program
     .option("-p, --project <id>", "Set project context")
     .option("--skip-context", "Skip workspace/project selection")
     .option("--skip-docs", "Skip project docs scaffold/verification")
+    .option("--new", "Create a new account (skip the choice prompt)")
+    .option("-n, --name <name>", "Full name (for account creation)")
     .action(async (options) => {
     await runSetup({
         force: options.force,
@@ -124,6 +131,8 @@ program
         projectId: options.project,
         skipContext: options.skipContext,
         skipDocs: options.skipDocs,
+        newAccount: options.new,
+        name: options.name,
     });
 });
 program.parse();

package/dist/lib/onboard.js

@@ -0,0 +1,36 @@
+import { requestWithBearer, signupUser } from "./api-client.js";
+import { getApiUrl } from "./config.js";
+export async function onboardNewUser(params) {
+    const { email, password, fullName, workspaceName = `${fullName}'s Workspace`, projectName = "My First Board", template = "kanban", keyName = "mcp-agent", apiUrl = getApiUrl(), } = params;
+    // 1. Signup
+    const signupResult = await signupUser(apiUrl, {
+        email,
+        password,
+        full_name: fullName,
+    });
+    const token = signupResult.session.access_token;
+    // 2. Create workspace
+    const workspaceResult = await requestWithBearer(apiUrl, token, "POST", "/workspaces", {
+        name: workspaceName,
+    });
+    // 3. Create project
+    const projectResult = await requestWithBearer(apiUrl, token, "POST", "/projects", {
+        workspaceId: workspaceResult.workspace.id,
+        name: projectName,
+        template,
+    });
+    // 4. Generate API key
+    const keyResult = await requestWithBearer(apiUrl, token, "POST", "/api-keys", {
+        name: keyName,
+    });
+    return {
+        user: signupResult.user,
+        workspace: workspaceResult.workspace,
+        project: projectResult.project,
+        columns: projectResult.columns,
+        apiKey: {
+            rawKey: keyResult.rawKey,
+            prefix: keyResult.apiKey.prefix,
+        },
+    };
+}