@gethmy/mcp 2.5.7 → 2.7.0

package/dist/cli.js

@@ -69,6 +69,34 @@ function formatLabels(labels) {
   return `
 **Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
+function formatAttachments(attachments) {
+  if (!attachments || attachments.length === 0)
+    return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `
+## Attachments
+*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*
+${lines.join(`
+`)}`;
+}
+function formatExternalLinks(refs) {
+  if (!refs || refs.length === 0)
+    return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `
+## External References
+${lines.join(`
+`)}`;
+}
 function formatLinkedCards(links) {
   if (!links || links.length === 0)
     return "";
@@ -102,11 +130,15 @@ function generatePrompt(options) {
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions
   };
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
   const sections = [];
@@ -143,6 +175,12 @@ ${card.description}`);
   if (contextOpts.includeLinks && links.length > 0) {
     sections.push(formatLinkedCards(links));
   }
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
   sections.push(`
 ## Focus Areas`);
   roleFraming.focus.forEach((f) => {
@@ -1330,6 +1368,12 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
+  async archiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+  async unarchiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
   async getBoard(projectId, options) {
     const params = new URLSearchParams;
     if (options?.limit !== undefined)
@@ -1399,6 +1443,12 @@ class HarmonyApiClient {
   async getCardLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/links`);
   }
+  async getCardAttachments(cardId) {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+  async getCardExternalLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1479,6 +1529,51 @@ class HarmonyApiClient {
   async updateMemoryEntity(entityId, updates) {
     return this.request("PUT", `/memory/entities/${entityId}`, updates);
   }
+  async harmonyRecall(options) {
+    const fetchLimit = Math.max(options.topK ?? 3, 50);
+    let entities = [];
+    if (options.query) {
+      const search = await this.searchMemoryEntities(options.workspaceId, options.query, {
+        project_id: options.projectId,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        limit: fetchLimit
+      });
+      entities = search.entities ?? [];
+    } else {
+      const list = await this.listMemoryEntities({
+        workspace_id: options.workspaceId,
+        project_id: options.projectId,
+        scope: options.scope,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        tags: options.tags,
+        min_confidence: options.minConfidence,
+        limit: fetchLimit
+      });
+      entities = list.entities ?? [];
+    }
+    if (options.type && options.type.length > 1) {
+      const allowed = new Set(options.type);
+      entities = entities.filter((e) => allowed.has(e.type));
+    }
+    if (options.memory_tier) {
+      entities = entities.filter((e) => e.memory_tier === options.memory_tier);
+    }
+    if (options.scope) {
+      entities = entities.filter((e) => e.scope === options.scope);
+    }
+    if (options.tags?.length) {
+      const wanted = new Set(options.tags);
+      entities = entities.filter((e) => (e.tags ?? []).some((t) => wanted.has(t)));
+    }
+    if (typeof options.minConfidence === "number") {
+      const threshold = options.minConfidence;
+      entities = entities.filter((e) => typeof e.confidence === "number" && e.confidence >= threshold);
+    }
+    if (options.topK !== undefined) {
+      entities = entities.slice(0, options.topK);
+    }
+    return { entities };
+  }
   async deleteMemoryEntity(entityId) {
     return this.request("DELETE", `/memory/entities/${entityId}`);
   }
@@ -1665,6 +1760,30 @@ class HarmonyApiClient {
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map((att) => ({
+        id: att.id,
+        file_name: att.file_name,
+        file_type: att.file_type,
+        file_size: att.file_size,
+        signed_url: att.signed_url
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(options.cardId);
+      cardData.external_links = (externalLinksResult.external_links ?? []).map((link) => ({
+        id: link.id,
+        url: link.url,
+        title: link.title
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
     let columnData = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
     if (projectIdForBoard) {
@@ -1785,11 +1904,8 @@ function resolveAgentIdentity(info) {
 var AUTO_START_TRIGGERS = new Set([
   "harmony_generate_prompt",
   "harmony_update_card",
-  "harmony_move_card",
   "harmony_create_subtask",
-  "harmony_toggle_subtask",
-  "harmony_add_label_to_card",
-  "harmony_remove_label_from_card"
+  "harmony_toggle_subtask"
 ]);
 var INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000;
 var CHECK_INTERVAL_MS = 60 * 1000;
@@ -2459,6 +2575,26 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_archive_project: {
+    description: "Archive a project. Hides the project (and all its columns and cards) from the active workspace. Can be restored later with harmony_unarchive_project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to archive" }
+      },
+      required: ["projectId"]
+    }
+  },
+  harmony_unarchive_project: {
+    description: "Restore an archived project so it (and its content) becomes visible again.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to unarchive" }
+      },
+      required: ["projectId"]
+    }
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -2647,6 +2783,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_get_card_attachments: {
+    description: "Get all file attachments for a card with short-lived signed URLs. URLs expire after `signed_url_expires_in` seconds (default 3600). Re-fetch to refresh.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_get_card_external_links: {
+    description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_create_subtask: {
     description: "Create a subtask on a card",
     inputSchema: {
@@ -3785,6 +3947,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.unarchiveCard(cardId);
       return { success: true, ...result };
     }
+    case "harmony_archive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.archiveProject(projectId);
+      return { success: true, ...result };
+    }
+    case "harmony_unarchive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.unarchiveProject(projectId);
+      return { success: true, ...result };
+    }
     case "harmony_delete_card": {
       const cardId = z.string().uuid().parse(args.cardId);
       await client3.deleteCard(cardId);
@@ -3902,6 +4074,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardLinks(cardId);
       return result;
     }
+    case "harmony_get_card_attachments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardAttachments(cardId);
+      return result;
+    }
+    case "harmony_get_card_external_links": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardExternalLinks(cardId);
+      return result;
+    }
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);

package/dist/index.js

@@ -69,6 +69,34 @@ function formatLabels(labels) {
   return `
 **Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
+function formatAttachments(attachments) {
+  if (!attachments || attachments.length === 0)
+    return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `
+## Attachments
+*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*
+${lines.join(`
+`)}`;
+}
+function formatExternalLinks(refs) {
+  if (!refs || refs.length === 0)
+    return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `
+## External References
+${lines.join(`
+`)}`;
+}
 function formatLinkedCards(links) {
   if (!links || links.length === 0)
     return "";
@@ -102,11 +130,15 @@ function generatePrompt(options) {
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions
   };
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
   const sections = [];
@@ -143,6 +175,12 @@ ${card.description}`);
   if (contextOpts.includeLinks && links.length > 0) {
     sections.push(formatLinkedCards(links));
   }
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
   sections.push(`
 ## Focus Areas`);
   roleFraming.focus.forEach((f) => {
@@ -1326,6 +1364,12 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
+  async archiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+  async unarchiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
   async getBoard(projectId, options) {
     const params = new URLSearchParams;
     if (options?.limit !== undefined)
@@ -1395,6 +1439,12 @@ class HarmonyApiClient {
   async getCardLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/links`);
   }
+  async getCardAttachments(cardId) {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+  async getCardExternalLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1475,6 +1525,51 @@ class HarmonyApiClient {
   async updateMemoryEntity(entityId, updates) {
     return this.request("PUT", `/memory/entities/${entityId}`, updates);
   }
+  async harmonyRecall(options) {
+    const fetchLimit = Math.max(options.topK ?? 3, 50);
+    let entities = [];
+    if (options.query) {
+      const search = await this.searchMemoryEntities(options.workspaceId, options.query, {
+        project_id: options.projectId,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        limit: fetchLimit
+      });
+      entities = search.entities ?? [];
+    } else {
+      const list = await this.listMemoryEntities({
+        workspace_id: options.workspaceId,
+        project_id: options.projectId,
+        scope: options.scope,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        tags: options.tags,
+        min_confidence: options.minConfidence,
+        limit: fetchLimit
+      });
+      entities = list.entities ?? [];
+    }
+    if (options.type && options.type.length > 1) {
+      const allowed = new Set(options.type);
+      entities = entities.filter((e) => allowed.has(e.type));
+    }
+    if (options.memory_tier) {
+      entities = entities.filter((e) => e.memory_tier === options.memory_tier);
+    }
+    if (options.scope) {
+      entities = entities.filter((e) => e.scope === options.scope);
+    }
+    if (options.tags?.length) {
+      const wanted = new Set(options.tags);
+      entities = entities.filter((e) => (e.tags ?? []).some((t) => wanted.has(t)));
+    }
+    if (typeof options.minConfidence === "number") {
+      const threshold = options.minConfidence;
+      entities = entities.filter((e) => typeof e.confidence === "number" && e.confidence >= threshold);
+    }
+    if (options.topK !== undefined) {
+      entities = entities.slice(0, options.topK);
+    }
+    return { entities };
+  }
   async deleteMemoryEntity(entityId) {
     return this.request("DELETE", `/memory/entities/${entityId}`);
   }
@@ -1661,6 +1756,30 @@ class HarmonyApiClient {
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map((att) => ({
+        id: att.id,
+        file_name: att.file_name,
+        file_type: att.file_type,
+        file_size: att.file_size,
+        signed_url: att.signed_url
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(options.cardId);
+      cardData.external_links = (externalLinksResult.external_links ?? []).map((link) => ({
+        id: link.id,
+        url: link.url,
+        title: link.title
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
     let columnData = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
     if (projectIdForBoard) {
@@ -1781,11 +1900,8 @@ function resolveAgentIdentity(info) {
 var AUTO_START_TRIGGERS = new Set([
   "harmony_generate_prompt",
   "harmony_update_card",
-  "harmony_move_card",
   "harmony_create_subtask",
-  "harmony_toggle_subtask",
-  "harmony_add_label_to_card",
-  "harmony_remove_label_from_card"
+  "harmony_toggle_subtask"
 ]);
 var INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000;
 var CHECK_INTERVAL_MS = 60 * 1000;
@@ -2455,6 +2571,26 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_archive_project: {
+    description: "Archive a project. Hides the project (and all its columns and cards) from the active workspace. Can be restored later with harmony_unarchive_project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to archive" }
+      },
+      required: ["projectId"]
+    }
+  },
+  harmony_unarchive_project: {
+    description: "Restore an archived project so it (and its content) becomes visible again.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to unarchive" }
+      },
+      required: ["projectId"]
+    }
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -2643,6 +2779,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_get_card_attachments: {
+    description: "Get all file attachments for a card with short-lived signed URLs. URLs expire after `signed_url_expires_in` seconds (default 3600). Re-fetch to refresh.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_get_card_external_links: {
+    description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_create_subtask: {
     description: "Create a subtask on a card",
     inputSchema: {
@@ -3781,6 +3943,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.unarchiveCard(cardId);
       return { success: true, ...result };
     }
+    case "harmony_archive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.archiveProject(projectId);
+      return { success: true, ...result };
+    }
+    case "harmony_unarchive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.unarchiveProject(projectId);
+      return { success: true, ...result };
+    }
     case "harmony_delete_card": {
       const cardId = z.string().uuid().parse(args.cardId);
       await client3.deleteCard(cardId);
@@ -3898,6 +4070,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardLinks(cardId);
       return result;
     }
+    case "harmony_get_card_attachments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardAttachments(cardId);
+      return result;
+    }
+    case "harmony_get_card_external_links": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardExternalLinks(cardId);
+      return result;
+    }
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);

package/dist/lib/api-client.js

@@ -66,6 +66,34 @@ function formatLabels(labels) {
   return `
 **Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
+function formatAttachments(attachments) {
+  if (!attachments || attachments.length === 0)
+    return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `
+## Attachments
+*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*
+${lines.join(`
+`)}`;
+}
+function formatExternalLinks(refs) {
+  if (!refs || refs.length === 0)
+    return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `
+## External References
+${lines.join(`
+`)}`;
+}
 function formatLinkedCards(links) {
   if (!links || links.length === 0)
     return "";
@@ -99,11 +127,15 @@ function generatePrompt(options) {
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions
   };
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
   const sections = [];
@@ -140,6 +172,12 @@ ${card.description}`);
   if (contextOpts.includeLinks && links.length > 0) {
     sections.push(formatLinkedCards(links));
   }
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
   sections.push(`
 ## Focus Areas`);
   roleFraming.focus.forEach((f) => {
@@ -933,6 +971,12 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
+  async archiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+  async unarchiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
   async getBoard(projectId, options) {
     const params = new URLSearchParams;
     if (options?.limit !== undefined)
@@ -1002,6 +1046,12 @@ class HarmonyApiClient {
   async getCardLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/links`);
   }
+  async getCardAttachments(cardId) {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+  async getCardExternalLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1082,6 +1132,51 @@ class HarmonyApiClient {
   async updateMemoryEntity(entityId, updates) {
     return this.request("PUT", `/memory/entities/${entityId}`, updates);
   }
+  async harmonyRecall(options) {
+    const fetchLimit = Math.max(options.topK ?? 3, 50);
+    let entities = [];
+    if (options.query) {
+      const search = await this.searchMemoryEntities(options.workspaceId, options.query, {
+        project_id: options.projectId,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        limit: fetchLimit
+      });
+      entities = search.entities ?? [];
+    } else {
+      const list = await this.listMemoryEntities({
+        workspace_id: options.workspaceId,
+        project_id: options.projectId,
+        scope: options.scope,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        tags: options.tags,
+        min_confidence: options.minConfidence,
+        limit: fetchLimit
+      });
+      entities = list.entities ?? [];
+    }
+    if (options.type && options.type.length > 1) {
+      const allowed = new Set(options.type);
+      entities = entities.filter((e) => allowed.has(e.type));
+    }
+    if (options.memory_tier) {
+      entities = entities.filter((e) => e.memory_tier === options.memory_tier);
+    }
+    if (options.scope) {
+      entities = entities.filter((e) => e.scope === options.scope);
+    }
+    if (options.tags?.length) {
+      const wanted = new Set(options.tags);
+      entities = entities.filter((e) => (e.tags ?? []).some((t) => wanted.has(t)));
+    }
+    if (typeof options.minConfidence === "number") {
+      const threshold = options.minConfidence;
+      entities = entities.filter((e) => typeof e.confidence === "number" && e.confidence >= threshold);
+    }
+    if (options.topK !== undefined) {
+      entities = entities.slice(0, options.topK);
+    }
+    return { entities };
+  }
   async deleteMemoryEntity(entityId) {
     return this.request("DELETE", `/memory/entities/${entityId}`);
   }
@@ -1268,6 +1363,30 @@ class HarmonyApiClient {
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map((att) => ({
+        id: att.id,
+        file_name: att.file_name,
+        file_type: att.file_type,
+        file_size: att.file_size,
+        signed_url: att.signed_url
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(options.cardId);
+      cardData.external_links = (externalLinksResult.external_links ?? []).map((link) => ({
+        id: link.id,
+        url: link.url,
+        title: link.title
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
     let columnData = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
     if (projectIdForBoard) {

package/package.json

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

package/src/api-client.ts

@@ -124,6 +124,28 @@ export class HarmonyUnauthorizedError extends Error {
   }
 }
 
+export interface CardAttachment {
+  id: string;
+  card_id: string;
+  file_name: string;
+  file_type: string;
+  file_size: number;
+  storage_path: string;
+  uploaded_by: string | null;
+  created_at: string;
+  signed_url: string | null;
+  signed_url_expires_in: number;
+}
+
+export interface CardExternalLinkRow {
+  id: string;
+  card_id: string;
+  url: string;
+  title: string | null;
+  created_by: string | null;
+  created_at: string;
+}
+
 export class HarmonyApiClient {
   private apiKey: string;
   private apiUrl: string;
@@ -376,6 +398,14 @@ export class HarmonyApiClient {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
 
+  async archiveProject(projectId: string): Promise<{ project: unknown }> {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+
+  async unarchiveProject(projectId: string): Promise<{ project: unknown }> {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
+
   async getBoard(
     projectId: string,
     options?: {
@@ -524,6 +554,18 @@ export class HarmonyApiClient {
     return this.request("GET", `/cards/${cardId}/links`);
   }
 
+  async getCardAttachments(
+    cardId: string,
+  ): Promise<{ attachments: CardAttachment[] }> {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+
+  async getCardExternalLinks(
+    cardId: string,
+  ): Promise<{ external_links: CardExternalLinkRow[] }> {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
+
   // ============ COLUMN OPERATIONS ============
 
   async createColumn(
@@ -743,15 +785,101 @@ export class HarmonyApiClient {
       scope?: string;
       type?: string;
       memory_tier?: string;
-      // AGP lifecycle fields. Backend may not yet whitelist these — extra keys
-      // are dropped server-side, leaving the call as a no-op for those fields.
+      // Supersede semantics — used by Phase 1.5 review-reject back-fill to
+      // tombstone the original implement episode without hard-deleting it.
+      // The backend sets superseded_at automatically when superseded_by lands.
       superseded_by?: string | null;
+      superseded_at?: string | null;
       version?: number;
     },
   ): Promise<{ entity: unknown; warnings?: string[] }> {
     return this.request("PUT", `/memory/entities/${entityId}`, updates);
   }
 
+  /**
+   * Retrieve memories filtered by type/tier/scope, optionally ranked by a
+   * free-text query. Wraps `searchMemoryEntities` (when a query is given)
+   * or `listMemoryEntities` and applies client-side filters that the REST
+   * surface doesn't natively expose (multi-type, memory_tier).
+   *
+   * Used by the agent daemon's read hook to surface similar past episodes
+   * before building a new task prompt (Phase 1.5).
+   */
+  async harmonyRecall(options: {
+    workspaceId: string;
+    projectId?: string;
+    query?: string;
+    type?: string[];
+    memory_tier?: string;
+    scope?: string;
+    tags?: string[];
+    minConfidence?: number;
+    topK?: number;
+  }): Promise<{ entities: unknown[] }> {
+    // Over-fetch beyond topK so client-side filters (multi-type, memory_tier,
+    // tags) have headroom — matches the MCP server's recall path (server.ts).
+    const fetchLimit = Math.max(options.topK ?? 3, 50);
+    let entities: Array<Record<string, unknown>> = [];
+
+    if (options.query) {
+      // searchMemoryEntities accepts a single type — refine client-side
+      // when the caller passed multiple.
+      const search = await this.searchMemoryEntities(
+        options.workspaceId,
+        options.query,
+        {
+          project_id: options.projectId,
+          type: options.type?.length === 1 ? options.type[0] : undefined,
+          limit: fetchLimit,
+        },
+      );
+      entities = (search.entities ?? []) as Array<Record<string, unknown>>;
+    } else {
+      const list = await this.listMemoryEntities({
+        workspace_id: options.workspaceId,
+        project_id: options.projectId,
+        scope: options.scope,
+        type: options.type?.length === 1 ? options.type[0] : undefined,
+        tags: options.tags,
+        min_confidence: options.minConfidence,
+        limit: fetchLimit,
+      });
+      entities = (list.entities ?? []) as Array<Record<string, unknown>>;
+    }
+
+    // Client-side filters: REST surface lacks multi-type and memory_tier.
+    if (options.type && options.type.length > 1) {
+      const allowed = new Set(options.type);
+      entities = entities.filter((e) => allowed.has(e.type as string));
+    }
+    if (options.memory_tier) {
+      entities = entities.filter((e) => e.memory_tier === options.memory_tier);
+    }
+    if (options.scope) {
+      entities = entities.filter((e) => e.scope === options.scope);
+    }
+    if (options.tags?.length) {
+      const wanted = new Set(options.tags);
+      entities = entities.filter((e) =>
+        ((e.tags as string[]) ?? []).some((t) => wanted.has(t)),
+      );
+    }
+    if (typeof options.minConfidence === "number") {
+      const threshold = options.minConfidence;
+      entities = entities.filter(
+        (e) =>
+          typeof e.confidence === "number" &&
+          (e.confidence as number) >= threshold,
+      );
+    }
+
+    if (options.topK !== undefined) {
+      entities = entities.slice(0, options.topK);
+    }
+
+    return { entities };
+  }
+
   async deleteMemoryEntity(entityId: string): Promise<{ success: boolean }> {
     return this.request("DELETE", `/memory/entities/${entityId}`);
   }
@@ -1196,6 +1324,40 @@ export class HarmonyApiClient {
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
 
+    // Fetch attachments + external links. Best-effort — never break prompt
+    // generation if storage signing or the underlying tables fail.
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map(
+        (att) => ({
+          id: att.id,
+          file_name: att.file_name,
+          file_type: att.file_type,
+          file_size: att.file_size,
+          signed_url: att.signed_url,
+        }),
+      );
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(
+        options.cardId,
+      );
+      cardData.external_links = (externalLinksResult.external_links ?? []).map(
+        (link) => ({
+          id: link.id,
+          url: link.url,
+          title: link.title,
+        }),
+      );
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
+
     // Try to get column info
     let columnData: { name: string } | null = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
@@ -1309,6 +1471,18 @@ interface CardPromptData {
     direction: "outgoing" | "incoming";
   }>;
   assignee?: { full_name?: string; email: string } | null;
+  attachments?: Array<{
+    id: string;
+    file_name: string;
+    file_type: string;
+    file_size: number;
+    signed_url: string | null;
+  }>;
+  external_links?: Array<{
+    id: string;
+    url: string;
+    title?: string | null;
+  }>;
   column_id?: string;
   project_id?: string;
 }

package/src/auto-session.ts

@@ -65,15 +65,19 @@ export function resolveAgentIdentity(info: ClientInfo | null): {
   return { agentIdentifier: key, agentName: displayName };
 }
 
-/** Tools that trigger auto-start of a session */
+/**
+ * Tools that trigger auto-start of a session.
+ *
+ * Restricted to tools that signal real work on a card. Board-management ops
+ * (move, label add/remove) are excluded — they're routinely used for triage
+ * and would create false-positive sessions whose side effect (the auto-added
+ * `agent` label on the card) confuses both UI and humans.
+ */
 export const AUTO_START_TRIGGERS = new Set([
   "harmony_generate_prompt",
   "harmony_update_card",
-  "harmony_move_card",
   "harmony_create_subtask",
   "harmony_toggle_subtask",
-  "harmony_add_label_to_card",
-  "harmony_remove_label_from_card",
 ]);
 
 export const INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes

package/src/prompt-builder.ts

@@ -44,6 +44,8 @@ export interface PromptContextOptions {
   includePriority: boolean;
   includeLinks: boolean;
   includeColumn: boolean;
+  includeAttachments: boolean;
+  includeExternalLinks: boolean;
 }
 
 export interface RoleFraming {
@@ -307,6 +309,27 @@ function formatLabels(labels: Array<{ name: string }>): string {
   return `\n**Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
 
+function formatAttachments(attachments: CardAttachmentRef[]): string {
+  if (!attachments || attachments.length === 0) return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `\n## Attachments\n*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*\n${lines.join("\n")}`;
+}
+
+function formatExternalLinks(refs: CardExternalLinkRef[]): string {
+  if (!refs || refs.length === 0) return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `\n## External References\n${lines.join("\n")}`;
+}
+
 /**
  * Format linked cards for prompt
  */
@@ -325,6 +348,20 @@ function formatLinkedCards(
   return `\n## Related Cards\n${lines.join("\n")}`;
 }
 
+export interface CardAttachmentRef {
+  id: string;
+  file_name: string;
+  file_type: string;
+  file_size: number;
+  signed_url: string | null;
+}
+
+export interface CardExternalLinkRef {
+  id: string;
+  url: string;
+  title?: string | null;
+}
+
 export interface CardData {
   id: string;
   short_id: number;
@@ -341,6 +378,8 @@ export interface CardData {
     direction: "outgoing" | "incoming";
   }>;
   assignee?: { full_name?: string; email: string } | null;
+  attachments?: CardAttachmentRef[];
+  external_links?: CardExternalLinkRef[];
 }
 
 export interface ColumnData {
@@ -397,12 +436,16 @@ export function generatePrompt(
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions,
   };
 
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
 
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
@@ -456,6 +499,16 @@ export function generatePrompt(
     sections.push(formatLinkedCards(links));
   }
 
+  // Attachments (signed URLs) — fetchable image/file references
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+
+  // External URL references (docs, gists, dashboards)
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
+
   // Focus areas
   sections.push(`\n## Focus Areas`);
   roleFraming.focus.forEach((f) => {

package/src/server.ts

@@ -348,6 +348,28 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_archive_project: {
+    description:
+      "Archive a project. Hides the project (and all its columns and cards) from the active workspace. Can be restored later with harmony_unarchive_project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to archive" },
+      },
+      required: ["projectId"],
+    },
+  },
+  harmony_unarchive_project: {
+    description:
+      "Restore an archived project so it (and its content) becomes visible again.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to unarchive" },
+      },
+      required: ["projectId"],
+    },
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -546,6 +568,34 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_get_card_attachments: {
+    description:
+      "Get all file attachments for a card with short-lived signed URLs. URLs expire after `signed_url_expires_in` seconds (default 3600). Re-fetch to refresh.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID",
+        },
+      },
+      required: ["cardId"],
+    },
+  },
+  harmony_get_card_external_links: {
+    description:
+      "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID",
+        },
+      },
+      required: ["cardId"],
+    },
+  },
 
   // Subtask operations
   harmony_create_subtask: {
@@ -1908,6 +1958,18 @@ async function handleToolCall(
       return { success: true, ...result };
     }
 
+    case "harmony_archive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client.archiveProject(projectId);
+      return { success: true, ...result };
+    }
+
+    case "harmony_unarchive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client.unarchiveProject(projectId);
+      return { success: true, ...result };
+    }
+
     case "harmony_delete_card": {
       const cardId = z.string().uuid().parse(args.cardId);
       await client.deleteCard(cardId);
@@ -2074,6 +2136,18 @@ async function handleToolCall(
       return result;
     }
 
+    case "harmony_get_card_attachments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client.getCardAttachments(cardId);
+      return result;
+    }
+
+    case "harmony_get_card_external_links": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client.getCardExternalLinks(cardId);
+      return result;
+    }
+
     // Subtask operations
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);