@gethmy/mcp 2.3.2 → 2.3.4

package/dist/cli.js

@@ -28465,6 +28465,85 @@ function generateHealthReport(report) {
   return lines.join(`
 `);
 }
+async function purgeMemories(client3, workspaceId, projectId, options) {
+  const dryRun = options.dryRun !== false;
+  const { filters } = options;
+  const hasFilter = filters.tier || filters.scope || filters.type || filters.olderThanDays !== undefined || filters.maxConfidence !== undefined || filters.tags && filters.tags.length > 0;
+  if (!hasFilter) {
+    throw new Error("At least one narrowing filter (tier, scope, type, olderThanDays, maxConfidence, tags) is required.");
+  }
+  const allMatches = [];
+  let offset = 0;
+  const pageSize = 100;
+  const now = Date.now();
+  while (true) {
+    const result = await client3.listMemoryEntities({
+      workspace_id: workspaceId,
+      project_id: projectId,
+      type: filters.type,
+      scope: filters.scope,
+      tags: filters.tags,
+      limit: pageSize,
+      offset
+    });
+    const entities = result.entities || [];
+    if (entities.length === 0)
+      break;
+    for (const entity of entities) {
+      if (filters.tier && entity.memory_tier !== filters.tier)
+        continue;
+      if (filters.maxConfidence !== undefined && entity.confidence > filters.maxConfidence)
+        continue;
+      if (filters.olderThanDays !== undefined) {
+        const ref = entity.last_accessed_at || entity.created_at;
+        const ageDays = (now - new Date(ref).getTime()) / MS_PER_DAY;
+        if (ageDays < filters.olderThanDays)
+          continue;
+      }
+      allMatches.push(entity);
+    }
+    if (entities.length < pageSize)
+      break;
+    offset += pageSize;
+  }
+  const items = allMatches.map((e) => ({
+    id: e.id,
+    title: e.title,
+    type: e.type,
+    tier: e.memory_tier,
+    confidence: e.confidence,
+    ageDays: Math.round((now - new Date(e.last_accessed_at || e.created_at).getTime()) / MS_PER_DAY)
+  }));
+  const errors3 = [];
+  let purged = 0;
+  if (!dryRun) {
+    for (let i = 0;i < allMatches.length; i += CONCURRENCY_LIMIT) {
+      const batch = allMatches.slice(i, i + CONCURRENCY_LIMIT);
+      const results = await Promise.allSettled(batch.map((e) => client3.deleteMemoryEntity(e.id)));
+      for (let j = 0;j < results.length; j++) {
+        if (results[j].status === "fulfilled") {
+          purged++;
+        } else {
+          errors3.push({
+            entityId: batch[j].id,
+            message: results[j].status === "rejected" ? String(results[j].reason) : "Unknown error"
+          });
+        }
+      }
+    }
+  }
+  return {
+    success: errors3.length === 0,
+    dryRun,
+    timestamp: new Date().toISOString(),
+    workspace: { id: workspaceId, projectId },
+    filters,
+    matched: allMatches.length,
+    purged: dryRun ? 0 : purged,
+    items,
+    errors: errors3
+  };
+}
 
 // src/onboard.ts
 async function onboardNewUser(params) {
@@ -29060,6 +29139,20 @@ var TOOLS = {
         estimatedMinutesRemaining: {
           type: "number",
           description: "Updated time estimate"
+        },
+        actions: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              description: {
+                type: "string",
+                description: "What was done, e.g. 'Edited CardDetailSheet.tsx — added done toggle'"
+              }
+            },
+            required: ["description"]
+          },
+          description: "Actions performed since last update. Each becomes a visible activity log entry."
         }
       },
       required: ["cardId", "agentIdentifier", "agentName"]
@@ -29941,6 +30034,53 @@ var TOOLS = {
       },
       required: []
     }
+  },
+  harmony_purge_memories: {
+    description: "Bulk-delete memory entities matching filters within a project. Requires at least one narrowing filter (tier, scope, type, olderThanDays, maxConfidence, tags). Dry-run by default — preview what would be deleted before executing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspaceId: {
+          type: "string",
+          description: "Workspace ID (optional if context set)"
+        },
+        projectId: {
+          type: "string",
+          description: "Project ID (required — purge is project-scoped). Falls back to active project context."
+        },
+        dryRun: {
+          type: "boolean",
+          description: "Preview what would be deleted without executing (default: true)"
+        },
+        tier: {
+          type: "string",
+          enum: ["draft", "episode", "reference"],
+          description: 'Filter by memory tier (e.g. "draft")'
+        },
+        scope: {
+          type: "string",
+          description: 'Filter by scope (e.g. "private", "project", "workspace")'
+        },
+        type: {
+          type: "string",
+          description: 'Filter by entity type (e.g. "error", "pattern", "lesson", "decision")'
+        },
+        olderThanDays: {
+          type: "number",
+          description: "Only include entities not accessed in at least this many days"
+        },
+        maxConfidence: {
+          type: "number",
+          description: "Only include entities with confidence at or below this value (e.g. 0.3 for low-confidence junk)"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Only include entities matching these tags"
+        }
+      },
+      required: []
+    }
   }
 };
 var RESOURCES = [
@@ -30570,12 +30710,20 @@ async function handleToolCall(name, args, deps) {
       const agentIdentifier = exports_external.string().min(1).max(100).parse(args.agentIdentifier);
       const agentName = exports_external.string().min(1).max(100).parse(args.agentName);
       const progressPercent = args.progressPercent !== undefined ? exports_external.number().min(0).max(100).parse(args.progressPercent) : undefined;
-      const callerRecentActions = args.recentActions;
+      const callerActions = args.actions;
+      const now = new Date().toISOString();
+      const callerRecentActions = [
+        ...args.recentActions || [],
+        ...(callerActions || []).map((a) => ({
+          action: a.description,
+          ts: now
+        }))
+      ];
       const memSession = getMemorySession(cardId);
       let mergedRecentActions;
       if (memSession?.dirty) {
-        mergedRecentActions = mergeMemoryActionsInto(cardId, callerRecentActions || []);
-      } else if (callerRecentActions) {
+        mergedRecentActions = mergeMemoryActionsInto(cardId, callerRecentActions);
+      } else if (callerRecentActions.length > 0) {
         mergedRecentActions = callerRecentActions;
       }
       const result = await client3.updateAgentProgress(cardId, {
@@ -31485,6 +31633,42 @@ async function handleToolCall(name, args, deps) {
         healthReport: report.healthReport
       };
     }
+    case "harmony_purge_memories": {
+      const workspaceId = args.workspaceId || deps.getActiveWorkspaceId();
+      if (!workspaceId) {
+        throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
+      }
+      const projectId = args.projectId || deps.getActiveProjectId();
+      if (!projectId) {
+        throw new Error("No project specified. Purge requires a project scope. Use harmony_set_project_context or provide projectId.");
+      }
+      const filters = {};
+      if (args.tier)
+        filters.tier = args.tier;
+      if (args.scope)
+        filters.scope = args.scope;
+      if (args.type)
+        filters.type = args.type;
+      if (args.olderThanDays !== undefined)
+        filters.olderThanDays = args.olderThanDays;
+      if (args.maxConfidence !== undefined)
+        filters.maxConfidence = args.maxConfidence;
+      if (args.tags)
+        filters.tags = args.tags;
+      const report = await purgeMemories(client3, workspaceId, projectId, {
+        dryRun: args.dryRun,
+        filters
+      });
+      return {
+        success: report.success,
+        dryRun: report.dryRun,
+        matched: report.matched,
+        purged: report.purged,
+        items: report.items,
+        errors: report.errors,
+        message: report.dryRun ? `Found ${report.matched} entities matching filters. Run with dryRun=false to delete.` : `Purged ${report.purged} of ${report.matched} matching entities.`
+      };
+    }
     default:
       throw new Error(`Unknown tool: ${name}`);
   }
@@ -31522,15 +31706,26 @@ class HarmonyMCPServer {
       const cv = this.server.getClientVersion();
       return cv ? { name: cv.name, version: cv.version } : null;
     });
+    let exitCode = 0;
     const handleShutdown = async () => {
       try {
         await shutdownAllSessions();
       } catch {}
       destroyAutoSession();
-      process.exit(0);
+      process.exit(exitCode);
     };
     process.on("SIGINT", handleShutdown);
     process.on("SIGTERM", handleShutdown);
+    process.on("uncaughtException", (err) => {
+      console.error("MCP server uncaught exception:", err);
+      exitCode = 1;
+      handleShutdown();
+    });
+    process.on("unhandledRejection", (reason) => {
+      console.error("MCP server unhandled rejection:", reason);
+      exitCode = 1;
+      handleShutdown();
+    });
     try {
       if (isConfigured()) {
         const workspaceId = getActiveWorkspaceId();

package/dist/index.js

@@ -26225,6 +26225,85 @@ function generateHealthReport(report) {
   return lines.join(`
 `);
 }
+async function purgeMemories(client3, workspaceId, projectId, options) {
+  const dryRun = options.dryRun !== false;
+  const { filters } = options;
+  const hasFilter = filters.tier || filters.scope || filters.type || filters.olderThanDays !== undefined || filters.maxConfidence !== undefined || filters.tags && filters.tags.length > 0;
+  if (!hasFilter) {
+    throw new Error("At least one narrowing filter (tier, scope, type, olderThanDays, maxConfidence, tags) is required.");
+  }
+  const allMatches = [];
+  let offset = 0;
+  const pageSize = 100;
+  const now = Date.now();
+  while (true) {
+    const result = await client3.listMemoryEntities({
+      workspace_id: workspaceId,
+      project_id: projectId,
+      type: filters.type,
+      scope: filters.scope,
+      tags: filters.tags,
+      limit: pageSize,
+      offset
+    });
+    const entities = result.entities || [];
+    if (entities.length === 0)
+      break;
+    for (const entity of entities) {
+      if (filters.tier && entity.memory_tier !== filters.tier)
+        continue;
+      if (filters.maxConfidence !== undefined && entity.confidence > filters.maxConfidence)
+        continue;
+      if (filters.olderThanDays !== undefined) {
+        const ref = entity.last_accessed_at || entity.created_at;
+        const ageDays = (now - new Date(ref).getTime()) / MS_PER_DAY;
+        if (ageDays < filters.olderThanDays)
+          continue;
+      }
+      allMatches.push(entity);
+    }
+    if (entities.length < pageSize)
+      break;
+    offset += pageSize;
+  }
+  const items = allMatches.map((e) => ({
+    id: e.id,
+    title: e.title,
+    type: e.type,
+    tier: e.memory_tier,
+    confidence: e.confidence,
+    ageDays: Math.round((now - new Date(e.last_accessed_at || e.created_at).getTime()) / MS_PER_DAY)
+  }));
+  const errors3 = [];
+  let purged = 0;
+  if (!dryRun) {
+    for (let i = 0;i < allMatches.length; i += CONCURRENCY_LIMIT) {
+      const batch = allMatches.slice(i, i + CONCURRENCY_LIMIT);
+      const results = await Promise.allSettled(batch.map((e) => client3.deleteMemoryEntity(e.id)));
+      for (let j = 0;j < results.length; j++) {
+        if (results[j].status === "fulfilled") {
+          purged++;
+        } else {
+          errors3.push({
+            entityId: batch[j].id,
+            message: results[j].status === "rejected" ? String(results[j].reason) : "Unknown error"
+          });
+        }
+      }
+    }
+  }
+  return {
+    success: errors3.length === 0,
+    dryRun,
+    timestamp: new Date().toISOString(),
+    workspace: { id: workspaceId, projectId },
+    filters,
+    matched: allMatches.length,
+    purged: dryRun ? 0 : purged,
+    items,
+    errors: errors3
+  };
+}
 
 // src/onboard.ts
 async function onboardNewUser(params) {
@@ -26820,6 +26899,20 @@ var TOOLS = {
         estimatedMinutesRemaining: {
           type: "number",
           description: "Updated time estimate"
+        },
+        actions: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              description: {
+                type: "string",
+                description: "What was done, e.g. 'Edited CardDetailSheet.tsx — added done toggle'"
+              }
+            },
+            required: ["description"]
+          },
+          description: "Actions performed since last update. Each becomes a visible activity log entry."
         }
       },
       required: ["cardId", "agentIdentifier", "agentName"]
@@ -27701,6 +27794,53 @@ var TOOLS = {
       },
       required: []
     }
+  },
+  harmony_purge_memories: {
+    description: "Bulk-delete memory entities matching filters within a project. Requires at least one narrowing filter (tier, scope, type, olderThanDays, maxConfidence, tags). Dry-run by default — preview what would be deleted before executing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspaceId: {
+          type: "string",
+          description: "Workspace ID (optional if context set)"
+        },
+        projectId: {
+          type: "string",
+          description: "Project ID (required — purge is project-scoped). Falls back to active project context."
+        },
+        dryRun: {
+          type: "boolean",
+          description: "Preview what would be deleted without executing (default: true)"
+        },
+        tier: {
+          type: "string",
+          enum: ["draft", "episode", "reference"],
+          description: 'Filter by memory tier (e.g. "draft")'
+        },
+        scope: {
+          type: "string",
+          description: 'Filter by scope (e.g. "private", "project", "workspace")'
+        },
+        type: {
+          type: "string",
+          description: 'Filter by entity type (e.g. "error", "pattern", "lesson", "decision")'
+        },
+        olderThanDays: {
+          type: "number",
+          description: "Only include entities not accessed in at least this many days"
+        },
+        maxConfidence: {
+          type: "number",
+          description: "Only include entities with confidence at or below this value (e.g. 0.3 for low-confidence junk)"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Only include entities matching these tags"
+        }
+      },
+      required: []
+    }
   }
 };
 var RESOURCES = [
@@ -28330,12 +28470,20 @@ async function handleToolCall(name, args, deps) {
       const agentIdentifier = exports_external.string().min(1).max(100).parse(args.agentIdentifier);
       const agentName = exports_external.string().min(1).max(100).parse(args.agentName);
       const progressPercent = args.progressPercent !== undefined ? exports_external.number().min(0).max(100).parse(args.progressPercent) : undefined;
-      const callerRecentActions = args.recentActions;
+      const callerActions = args.actions;
+      const now = new Date().toISOString();
+      const callerRecentActions = [
+        ...args.recentActions || [],
+        ...(callerActions || []).map((a) => ({
+          action: a.description,
+          ts: now
+        }))
+      ];
       const memSession = getMemorySession(cardId);
       let mergedRecentActions;
       if (memSession?.dirty) {
-        mergedRecentActions = mergeMemoryActionsInto(cardId, callerRecentActions || []);
-      } else if (callerRecentActions) {
+        mergedRecentActions = mergeMemoryActionsInto(cardId, callerRecentActions);
+      } else if (callerRecentActions.length > 0) {
         mergedRecentActions = callerRecentActions;
       }
       const result = await client3.updateAgentProgress(cardId, {
@@ -29245,6 +29393,42 @@ async function handleToolCall(name, args, deps) {
         healthReport: report.healthReport
       };
     }
+    case "harmony_purge_memories": {
+      const workspaceId = args.workspaceId || deps.getActiveWorkspaceId();
+      if (!workspaceId) {
+        throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
+      }
+      const projectId = args.projectId || deps.getActiveProjectId();
+      if (!projectId) {
+        throw new Error("No project specified. Purge requires a project scope. Use harmony_set_project_context or provide projectId.");
+      }
+      const filters = {};
+      if (args.tier)
+        filters.tier = args.tier;
+      if (args.scope)
+        filters.scope = args.scope;
+      if (args.type)
+        filters.type = args.type;
+      if (args.olderThanDays !== undefined)
+        filters.olderThanDays = args.olderThanDays;
+      if (args.maxConfidence !== undefined)
+        filters.maxConfidence = args.maxConfidence;
+      if (args.tags)
+        filters.tags = args.tags;
+      const report = await purgeMemories(client3, workspaceId, projectId, {
+        dryRun: args.dryRun,
+        filters
+      });
+      return {
+        success: report.success,
+        dryRun: report.dryRun,
+        matched: report.matched,
+        purged: report.purged,
+        items: report.items,
+        errors: report.errors,
+        message: report.dryRun ? `Found ${report.matched} entities matching filters. Run with dryRun=false to delete.` : `Purged ${report.purged} of ${report.matched} matching entities.`
+      };
+    }
     default:
       throw new Error(`Unknown tool: ${name}`);
   }
@@ -29282,15 +29466,26 @@ class HarmonyMCPServer {
       const cv = this.server.getClientVersion();
       return cv ? { name: cv.name, version: cv.version } : null;
     });
+    let exitCode = 0;
     const handleShutdown = async () => {
       try {
         await shutdownAllSessions();
       } catch {}
       destroyAutoSession();
-      process.exit(0);
+      process.exit(exitCode);
     };
     process.on("SIGINT", handleShutdown);
     process.on("SIGTERM", handleShutdown);
+    process.on("uncaughtException", (err) => {
+      console.error("MCP server uncaught exception:", err);
+      exitCode = 1;
+      handleShutdown();
+    });
+    process.on("unhandledRejection", (reason) => {
+      console.error("MCP server unhandled rejection:", reason);
+      exitCode = 1;
+      handleShutdown();
+    });
     try {
       if (isConfigured()) {
         const workspaceId = getActiveWorkspaceId();