@gethmy/mcp 2.22.0 → 2.24.0

package/dist/index.js

@@ -20,7 +20,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/config.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir } from "node:os";
-import { join as join2 } from "node:path";
+import { dirname, join as join2, parse, resolve } from "node:path";
 function getConfigDir() {
   return join2(homedir(), ".harmony-mcp");
 }
@@ -30,6 +30,22 @@ function getConfigPath() {
 function getLocalConfigPath(cwd) {
   return join2(cwd || process.cwd(), LOCAL_CONFIG_FILENAME);
 }
+function findLocalConfigPath(cwd) {
+  const home = resolve(homedir());
+  let dir = resolve(cwd || process.cwd());
+  const { root } = parse(dir);
+  for (;; ) {
+    if (dir !== home && dir !== root) {
+      const candidate = join2(dir, LOCAL_CONFIG_FILENAME);
+      if (existsSync2(candidate))
+        return candidate;
+    }
+    const parent = dirname(dir);
+    if (parent === dir)
+      return null;
+    dir = parent;
+  }
+}
 function emptyConfig() {
   return {
     apiKey: null,
@@ -81,8 +97,8 @@ function saveConfig(config) {
   });
 }
 function loadLocalConfig(cwd) {
-  const localConfigPath = getLocalConfigPath(cwd);
-  if (!existsSync2(localConfigPath)) {
+  const localConfigPath = findLocalConfigPath(cwd);
+  if (localConfigPath === null) {
     return null;
   }
   try {
@@ -97,7 +113,7 @@ function loadLocalConfig(cwd) {
   }
 }
 function saveLocalConfig(config, cwd) {
-  const localConfigPath = getLocalConfigPath(cwd);
+  const localConfigPath = findLocalConfigPath(cwd) ?? getLocalConfigPath(cwd);
   const existingConfig = loadLocalConfig(cwd) || {
     workspaceId: null,
     projectId: null
@@ -111,7 +127,7 @@ function saveLocalConfig(config, cwd) {
   writeFileSync2(localConfigPath, JSON.stringify(cleanConfig, null, 2));
 }
 function hasLocalConfig(cwd) {
-  return existsSync2(getLocalConfigPath(cwd));
+  return findLocalConfigPath(cwd) !== null;
 }
 function getActiveCredential() {
   const config = loadConfig();
@@ -133,33 +149,69 @@ function getUserEmail() {
   const config = loadConfig();
   return config.userEmail;
 }
-function setActiveWorkspace(workspaceId, options) {
-  if (options?.local) {
-    saveLocalConfig({ workspaceId }, options.cwd);
-  } else {
-    saveConfig({ activeWorkspaceId: workspaceId });
+function setActiveContext(context, options) {
+  if (options?.global) {
+    saveConfig({
+      activeWorkspaceId: context.workspaceId,
+      activeProjectId: context.projectId
+    });
+    return;
   }
-}
-function setActiveProject(projectId, options) {
-  if (options?.local) {
-    saveLocalConfig({ projectId }, options.cwd);
+  const localPath = findLocalConfigPath(options?.cwd);
+  if (options?.local || localPath !== null) {
+    saveLocalConfig({ workspaceId: context.workspaceId, projectId: context.projectId }, options?.cwd);
   } else {
-    saveConfig({ activeProjectId: projectId });
+    saveConfig({
+      activeWorkspaceId: context.workspaceId,
+      activeProjectId: context.projectId
+    });
   }
 }
-function getActiveWorkspaceId(cwd) {
+function setActiveWorkspace(workspaceId, options) {
+  const currentWorkspaceId = getActiveWorkspaceId(options?.cwd);
+  const keepProject = currentWorkspaceId === workspaceId;
+  setActiveContext({
+    workspaceId,
+    projectId: keepProject ? getActiveProjectId(options?.cwd) : null
+  }, options);
+}
+function readActiveContext(cwd) {
   const localConfig = loadLocalConfig(cwd);
-  if (localConfig?.workspaceId) {
-    return localConfig.workspaceId;
+  if (localConfig) {
+    return {
+      workspaceId: localConfig.workspaceId ?? null,
+      projectId: localConfig.projectId ?? null
+    };
   }
-  return loadConfig().activeWorkspaceId;
+  const globalConfig = loadConfig();
+  return {
+    workspaceId: globalConfig.activeWorkspaceId,
+    projectId: globalConfig.activeProjectId
+  };
+}
+function getActiveWorkspaceId(cwd) {
+  return readActiveContext(cwd).workspaceId;
 }
 function getActiveProjectId(cwd) {
-  const localConfig = loadLocalConfig(cwd);
-  if (localConfig?.projectId) {
-    return localConfig.projectId;
+  return readActiveContext(cwd).projectId;
+}
+function getActiveContext(cwd) {
+  return describeActiveContext({
+    projectId: getActiveProjectId(cwd),
+    workspaceId: getActiveWorkspaceId(cwd)
+  });
+}
+function describeActiveContext(context) {
+  const { projectId, workspaceId } = context;
+  if (projectId && !workspaceId) {
+    return {
+      projectId,
+      workspaceId,
+      consistent: false,
+      note: `An active project (${projectId}) is set with no active workspace, so ` + "workspace-scoped tools cannot resolve one from it. Re-set it with " + "harmony_set_project_context, or pass workspaceId explicitly."
+    };
   }
-  return loadConfig().activeProjectId;
+  return { projectId, workspaceId, consistent: true, note: null };
 }
 function isConfigured() {
   const config = loadConfig();
@@ -878,7 +930,7 @@ function lockPath() {
   return join3(getConfigDir(), LOCK_FILENAME);
 }
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 async function withRefreshLock(fn) {
   const path = lockPath();
@@ -1541,7 +1593,7 @@ function getRetryDelay(attempt) {
   const delay = Math.min(RETRY_CONFIG.baseDelayMs * 2 ** attempt, RETRY_CONFIG.maxDelayMs);
   return Math.round(delay + delay * 0.25 * (Math.random() * 2 - 1));
 }
-var sleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var sleep2 = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
 
 class Semaphore {
   permits;
@@ -1554,7 +1606,7 @@ class Semaphore {
       this.permits--;
       return;
     }
-    return new Promise((resolve) => this.queue.push(resolve));
+    return new Promise((resolve2) => this.queue.push(resolve2));
   }
   release() {
     const next = this.queue.shift();
@@ -2700,7 +2752,7 @@ async function autoExpandGraph(client3, entityId, title, content, _tags, workspa
     });
     candidates = entities.filter((e) => e.id !== entityId && (e.confidence ?? 1) >= 0.4).slice(0, maxRelations);
     if (candidates.length === 0) {
-      await new Promise((resolve) => setTimeout(resolve, 2000));
+      await new Promise((resolve2) => setTimeout(resolve2, 2000));
       const retry = await client3.searchMemoryEntities(workspaceId, query, {
         project_id: projectId,
         limit: 20
@@ -3292,7 +3344,7 @@ import {
   writeFileSync as writeFileSync3
 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { dirname, join as join5 } from "node:path";
+import { dirname as dirname2, join as join5 } from "node:path";
 init_config();
 
 // src/hmy-config.ts
@@ -3439,7 +3491,7 @@ function stripSkillPreamble(content) {
 `;
 }
 function atomicWrite(filePath, content) {
-  const dir = dirname(filePath);
+  const dir = dirname2(filePath);
   if (!existsSync4(dir))
     mkdirSync3(dir, { recursive: true });
   const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
@@ -3530,10 +3582,10 @@ async function refreshSkills(opts = {}) {
           continue;
         let siblingPath;
         if (samplePath.endsWith("SKILL.md")) {
-          const parentDir = dirname(dirname(samplePath));
+          const parentDir = dirname2(dirname2(samplePath));
           siblingPath = `${parentDir}/${name}/SKILL.md`;
         } else {
-          const parentDir = dirname(samplePath);
+          const parentDir = dirname2(samplePath);
           siblingPath = `${parentDir}/${name}.md`;
         }
         if (existsSync4(siblingPath)) {
@@ -4581,11 +4633,15 @@ var TOOLS = {
     }
   },
   harmony_set_project_context: {
-    description: "Set the active project context for subsequent operations",
+    description: "Set the active project context for subsequent operations. The project's workspace is set with it, so the two can never point at different places; pass workspaceId to skip the lookup.",
     inputSchema: {
       type: "object",
       properties: {
-        projectId: { type: "string" }
+        projectId: { type: "string" },
+        workspaceId: {
+          type: "string",
+          description: "The workspace this project belongs to. Optional — looked up when omitted."
+        }
       },
       required: ["projectId"]
     }
@@ -4652,6 +4708,11 @@ var TOOLS = {
         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."
+        },
+        driver: {
+          type: "string",
+          enum: ["daemon", "interactive", "script"],
+          description: 'Who is calling: the agent daemon, a human-driven interactive session, or an automation script. Names you as the holder if another caller hits a 409 on this card. Defaults to "interactive".'
         }
       },
       required: ["cardId", "agentIdentifier", "agentName"]
@@ -5384,13 +5445,26 @@ var TOOLS = {
           type: "array",
           description: "The playbook's ordered stage objects.",
           items: { type: "object" }
+        },
+        triggerType: {
+          type: "string",
+          enum: ["manual", "auto"],
+          description: "'manual' (default) — the playbook is applied by a person. 'auto' — it claims matching cards itself, and requires autoBind."
+        },
+        autoBind: {
+          type: "object",
+          description: "Auto-bind rule: {priority?: number, mode?: 'all'|'any', when: [{path, op, value}]}. Conditions are evaluated against the card's labels (lowercased), intent, complexity_score and priority with the gate operators eq/neq/gte/gt/lte/lt/contains/exists; 'contains' on labels is membership. Stored even while triggerType is 'manual', so a rule can be armed later without re-authoring it."
+        },
+        catalogId: {
+          type: "string",
+          description: "Slug of the built-in template this came from (provenance only; never used to match)."
         }
       },
       required: ["name"]
     }
   },
   harmony_update_playbook: {
-    description: "Update a playbook's name, description, steps/stages, enabled flag, or lifecycle state ('active'|'deprecated').",
+    description: "Update a playbook's name, description, steps/stages, enabled flag, lifecycle state ('active'|'deprecated'), or its auto-bind rule and arming.",
     inputSchema: {
       type: "object",
       properties: {
@@ -5413,6 +5487,15 @@ var TOOLS = {
           type: "string",
           enum: ["active", "deprecated"],
           description: "Lifecycle state"
+        },
+        triggerType: {
+          type: "string",
+          enum: ["manual", "auto"],
+          description: "Arm ('auto') or disarm ('manual') automatic application. Arming requires a rule to be present or supplied in the same call."
+        },
+        autoBind: {
+          type: "object",
+          description: "Replace the auto-bind rule: {priority?, mode?: 'all'|'any', when: [{path, op, value}]}. Pass null to remove it."
         }
       },
       required: ["playbookId"]
@@ -5877,7 +5960,10 @@ async function handleToolCall(name, args, deps) {
           const where = resolved.project.workspaceName ? `project "${resolved.project.name ?? resolved.project.id}" (workspace "${resolved.project.workspaceName}")` : `project "${resolved.project.name ?? resolved.project.id}"`;
           const established = activeProjectId == null;
           if (established) {
-            deps.setActiveProject(resolved.project.id);
+            deps.setActiveContext({
+              projectId: resolved.project.id,
+              workspaceId: resolved.project.workspaceId
+            });
           }
           return {
             success: true,
@@ -6316,15 +6402,57 @@ ${options}
     }
     case "harmony_set_project_context": {
       const projectId = z.string().uuid().parse(args.projectId);
-      deps.setActiveProject(projectId);
-      return { success: true, activeProjectId: projectId };
+      const explicitWorkspaceId = args.workspaceId ? z.string().uuid().parse(args.workspaceId) : null;
+      let owningWorkspaceId = explicitWorkspaceId;
+      if (!owningWorkspaceId) {
+        try {
+          const { workspaces } = await client3.listWorkspaces();
+          for (const workspace of workspaces) {
+            if (!workspace?.id)
+              continue;
+            const { projects } = await client3.listProjects(workspace.id);
+            if (projects.some((p) => p?.id === projectId)) {
+              owningWorkspaceId = workspace.id;
+              break;
+            }
+          }
+        } catch (error) {
+          const reason = error instanceof Error ? error.message : String(error);
+          return {
+            success: false,
+            activeProjectId: deps.getActiveProjectId(),
+            activeWorkspaceId: deps.getActiveWorkspaceId(),
+            note: `Could not resolve this project's workspace (${reason}), so the ` + `active context was left unchanged rather than half-written. ` + `Retry, or pass workspaceId explicitly to skip the lookup.`
+          };
+        }
+        if (!owningWorkspaceId) {
+          return {
+            success: false,
+            activeProjectId: deps.getActiveProjectId(),
+            activeWorkspaceId: deps.getActiveWorkspaceId(),
+            note: `Project ${projectId} is not in any workspace this connection ` + `can reach, so the active context was left unchanged. Check ` + `harmony_list_projects, pass workspaceId explicitly, or ` + `reconnect with /mcp if it lives in another workspace.`
+          };
+        }
+      }
+      deps.setActiveContext({ projectId, workspaceId: owningWorkspaceId });
+      return {
+        success: true,
+        activeProjectId: projectId,
+        activeWorkspaceId: owningWorkspaceId
+      };
     }
     case "harmony_get_context": {
+      const report = describeActiveContext({
+        projectId: deps.getActiveProjectId(),
+        workspaceId: deps.getActiveWorkspaceId()
+      });
       return {
         success: true,
         context: {
-          activeWorkspaceId: deps.getActiveWorkspaceId(),
-          activeProjectId: deps.getActiveProjectId()
+          activeWorkspaceId: report.workspaceId,
+          activeProjectId: report.projectId,
+          consistent: report.consistent,
+          ...report.note ? { note: report.note } : {}
         }
       };
     }
@@ -6406,7 +6534,8 @@ ${options}
         status: "working",
         currentTask: args.currentTask,
         estimatedMinutesRemaining: optionalNonNegativeNumberArg(args.estimatedMinutesRemaining, "estimatedMinutesRemaining"),
-        steerable: args.steerable === true || args.steerable === "true" ? true : undefined
+        steerable: args.steerable === true || args.steerable === "true" ? true : undefined,
+        driver: args.driver ?? "interactive"
       });
       markExplicit(cardId, {
         agentIdentifier,
@@ -7172,7 +7301,10 @@ ${options}
         workspaceId,
         name: name2,
         description: args.description,
-        steps: args.steps
+        steps: args.steps,
+        triggerType: args.triggerType,
+        autoBind: args.autoBind,
+        catalogId: args.catalogId
       });
       return { success: true, playbook: result.playbook };
     }
@@ -7183,7 +7315,9 @@ ${options}
         description: args.description,
         steps: args.steps,
         enabled: args.enabled,
-        state: args.state
+        state: args.state,
+        triggerType: args.triggerType,
+        ..."autoBind" in args ? { autoBind: args.autoBind } : {}
       });
       return { success: true, playbook: result.playbook };
     }
@@ -7260,8 +7394,10 @@ ${options}
         apiUrl: deps.getApiUrl()
       });
       deps.saveConfig({ apiKey: result.apiKey.rawKey });
-      deps.setActiveWorkspace(result.workspace.id);
-      deps.setActiveProject(result.project.id);
+      deps.setActiveContext({
+        projectId: result.project.id,
+        workspaceId: result.workspace.id
+      });
       deps.resetClient();
       return {
         success: true,
@@ -7283,7 +7419,7 @@ function createConfigDeps() {
     isConfigured,
     getActiveProjectId: () => getActiveProjectId(),
     getActiveWorkspaceId: () => getActiveWorkspaceId(),
-    setActiveProject: (id) => setActiveProject(id),
+    setActiveContext: (context) => setActiveContext(context),
     setActiveWorkspace: (id) => setActiveWorkspace(id),
     getApiUrl,
     getMemoryDir: () => getMemoryDir(),

package/dist/lib/api-client.js

@@ -17,7 +17,7 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { dirname, join, parse, resolve } from "node:path";
 function getConfigDir() {
   return join(homedir(), ".harmony-mcp");
 }
@@ -27,6 +27,22 @@ function getConfigPath() {
 function getLocalConfigPath(cwd) {
   return join(cwd || process.cwd(), LOCAL_CONFIG_FILENAME);
 }
+function findLocalConfigPath(cwd) {
+  const home = resolve(homedir());
+  let dir = resolve(cwd || process.cwd());
+  const { root } = parse(dir);
+  for (;; ) {
+    if (dir !== home && dir !== root) {
+      const candidate = join(dir, LOCAL_CONFIG_FILENAME);
+      if (existsSync(candidate))
+        return candidate;
+    }
+    const parent = dirname(dir);
+    if (parent === dir)
+      return null;
+    dir = parent;
+  }
+}
 function emptyConfig() {
   return {
     apiKey: null,
@@ -78,8 +94,8 @@ function saveConfig(config) {
   });
 }
 function loadLocalConfig(cwd) {
-  const localConfigPath = getLocalConfigPath(cwd);
-  if (!existsSync(localConfigPath)) {
+  const localConfigPath = findLocalConfigPath(cwd);
+  if (localConfigPath === null) {
     return null;
   }
   try {
@@ -94,7 +110,7 @@ function loadLocalConfig(cwd) {
   }
 }
 function saveLocalConfig(config, cwd) {
-  const localConfigPath = getLocalConfigPath(cwd);
+  const localConfigPath = findLocalConfigPath(cwd) ?? getLocalConfigPath(cwd);
   const existingConfig = loadLocalConfig(cwd) || {
     workspaceId: null,
     projectId: null
@@ -108,7 +124,7 @@ function saveLocalConfig(config, cwd) {
   writeFileSync(localConfigPath, JSON.stringify(cleanConfig, null, 2));
 }
 function hasLocalConfig(cwd) {
-  return existsSync(getLocalConfigPath(cwd));
+  return findLocalConfigPath(cwd) !== null;
 }
 function getActiveCredential() {
   const config = loadConfig();
@@ -133,33 +149,69 @@ function getUserEmail() {
 function setUserEmail(email) {
   saveConfig({ userEmail: email });
 }
-function setActiveWorkspace(workspaceId, options) {
-  if (options?.local) {
-    saveLocalConfig({ workspaceId }, options.cwd);
-  } else {
-    saveConfig({ activeWorkspaceId: workspaceId });
+function setActiveContext(context, options) {
+  if (options?.global) {
+    saveConfig({
+      activeWorkspaceId: context.workspaceId,
+      activeProjectId: context.projectId
+    });
+    return;
   }
-}
-function setActiveProject(projectId, options) {
-  if (options?.local) {
-    saveLocalConfig({ projectId }, options.cwd);
+  const localPath = findLocalConfigPath(options?.cwd);
+  if (options?.local || localPath !== null) {
+    saveLocalConfig({ workspaceId: context.workspaceId, projectId: context.projectId }, options?.cwd);
   } else {
-    saveConfig({ activeProjectId: projectId });
+    saveConfig({
+      activeWorkspaceId: context.workspaceId,
+      activeProjectId: context.projectId
+    });
   }
 }
-function getActiveWorkspaceId(cwd) {
+function setActiveWorkspace(workspaceId, options) {
+  const currentWorkspaceId = getActiveWorkspaceId(options?.cwd);
+  const keepProject = currentWorkspaceId === workspaceId;
+  setActiveContext({
+    workspaceId,
+    projectId: keepProject ? getActiveProjectId(options?.cwd) : null
+  }, options);
+}
+function readActiveContext(cwd) {
   const localConfig = loadLocalConfig(cwd);
-  if (localConfig?.workspaceId) {
-    return localConfig.workspaceId;
+  if (localConfig) {
+    return {
+      workspaceId: localConfig.workspaceId ?? null,
+      projectId: localConfig.projectId ?? null
+    };
   }
-  return loadConfig().activeWorkspaceId;
+  const globalConfig = loadConfig();
+  return {
+    workspaceId: globalConfig.activeWorkspaceId,
+    projectId: globalConfig.activeProjectId
+  };
+}
+function getActiveWorkspaceId(cwd) {
+  return readActiveContext(cwd).workspaceId;
 }
 function getActiveProjectId(cwd) {
-  const localConfig = loadLocalConfig(cwd);
-  if (localConfig?.projectId) {
-    return localConfig.projectId;
+  return readActiveContext(cwd).projectId;
+}
+function getActiveContext(cwd) {
+  return describeActiveContext({
+    projectId: getActiveProjectId(cwd),
+    workspaceId: getActiveWorkspaceId(cwd)
+  });
+}
+function describeActiveContext(context) {
+  const { projectId, workspaceId } = context;
+  if (projectId && !workspaceId) {
+    return {
+      projectId,
+      workspaceId,
+      consistent: false,
+      note: `An active project (${projectId}) is set with no active workspace, so ` + "workspace-scoped tools cannot resolve one from it. Re-set it with " + "harmony_set_project_context, or pass workspaceId explicitly."
+    };
   }
-  return loadConfig().activeProjectId;
+  return { projectId, workspaceId, consistent: true, note: null };
 }
 function isConfigured() {
   const config = loadConfig();
@@ -238,7 +290,7 @@ function lockPath() {
   return join2(getConfigDir(), LOCK_FILENAME);
 }
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 async function withRefreshLock(fn) {
   const path = lockPath();
@@ -993,7 +1045,7 @@ function getRetryDelay(attempt) {
   const delay = Math.min(RETRY_CONFIG.baseDelayMs * 2 ** attempt, RETRY_CONFIG.maxDelayMs);
   return Math.round(delay + delay * 0.25 * (Math.random() * 2 - 1));
 }
-var sleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var sleep2 = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
 
 class Semaphore {
   permits;
@@ -1006,7 +1058,7 @@ class Semaphore {
       this.permits--;
       return;
     }
-    return new Promise((resolve) => this.queue.push(resolve));
+    return new Promise((resolve2) => this.queue.push(resolve2));
   }
   release() {
     const next = this.queue.shift();