harmony-mcp 1.9.0 → 1.9.1

package/dist/cli.js

@@ -30216,37 +30216,50 @@ class HarmonyApiClient {
     this.apiKey = getApiKey();
     this.apiUrl = getApiUrl();
   }
-  async request(method, path, body) {
+  async request(method, path, body, options) {
     await requestSemaphore.acquire();
     try {
-      return await this.requestWithRetry(method, path, body);
+      return await this.requestWithRetry(method, path, body, options);
     } finally {
       requestSemaphore.release();
     }
   }
-  async requestWithRetry(method, path, body) {
+  async requestRaw(method, path, body, options) {
+    await requestSemaphore.acquire();
+    try {
+      return await this.requestRawWithRetry(method, path, body, options);
+    } finally {
+      requestSemaphore.release();
+    }
+  }
+  async requestWithRetry(method, path, body, options) {
     const url2 = `${this.apiUrl}/v1${path}`;
     let lastError = null;
+    const contentType = options?.contentType || "application/json";
+    const accept = options?.accept || "application/json";
     for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
       try {
         const response = await fetch(url2, {
           method,
           headers: {
-            "Content-Type": "application/json",
+            "Content-Type": contentType,
+            Accept: accept,
             "X-API-Key": this.apiKey
           },
-          body: body ? JSON.stringify(body) : undefined
+          body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
         });
         const data = await response.json();
         if (!response.ok) {
+          const errorMsg = data.error || `API error: ${response.status}`;
           if (!isRetryableError(null, response.status)) {
-            throw new Error(data.error || `API error: ${response.status}`);
+            throw new Error(errorMsg);
           }
-          lastError = new Error(data.error || `API error: ${response.status}`);
+          lastError = new Error(errorMsg);
           if (attempt < RETRY_CONFIG.maxRetries) {
             await sleep(getRetryDelay(attempt));
             continue;
           }
+          throw lastError;
         }
         return data;
       } catch (error48) {
@@ -30261,6 +30274,53 @@ class HarmonyApiClient {
     }
     throw lastError || new Error("Request failed after retries");
   }
+  async requestRawWithRetry(method, path, body, options) {
+    const url2 = `${this.apiUrl}/v1${path}`;
+    let lastError = null;
+    const contentType = options?.contentType || "application/json";
+    const accept = options?.accept || "text/markdown";
+    for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+      try {
+        const response = await fetch(url2, {
+          method,
+          headers: {
+            "Content-Type": contentType,
+            Accept: accept,
+            "X-API-Key": this.apiKey
+          },
+          body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
+        });
+        if (!response.ok) {
+          const text = await response.text();
+          let errorMsg;
+          try {
+            errorMsg = JSON.parse(text).error || `API error: ${response.status}`;
+          } catch {
+            errorMsg = text || `API error: ${response.status}`;
+          }
+          if (!isRetryableError(null, response.status)) {
+            throw new Error(errorMsg);
+          }
+          lastError = new Error(errorMsg);
+          if (attempt < RETRY_CONFIG.maxRetries) {
+            await sleep(getRetryDelay(attempt));
+            continue;
+          }
+          throw lastError;
+        }
+        return await response.text();
+      } catch (error48) {
+        lastError = error48 instanceof Error ? error48 : new Error(String(error48));
+        if (!isRetryableError(error48))
+          throw lastError;
+        if (attempt < RETRY_CONFIG.maxRetries) {
+          await sleep(getRetryDelay(attempt));
+          continue;
+        }
+      }
+    }
+    throw lastError || new Error("Request failed after retries");
+  }
   async listWorkspaces() {
     return this.request("GET", "/workspaces");
   }
@@ -30422,6 +30482,50 @@ class HarmonyApiClient {
       params.set("limit", String(options.limit));
     return this.request("GET", `/memory/search?${params.toString()}`);
   }
+  async listMemoryEntitiesMarkdown(options) {
+    const params = new URLSearchParams;
+    params.set("workspace_id", options.workspace_id);
+    if (options.project_id)
+      params.set("project_id", options.project_id);
+    if (options.type)
+      params.set("type", options.type);
+    if (options.scope)
+      params.set("scope", options.scope);
+    if (options.tags?.length)
+      params.set("tags", options.tags.join(","));
+    if (options.agent_identifier)
+      params.set("agent_identifier", options.agent_identifier);
+    if (options.min_confidence !== undefined)
+      params.set("min_confidence", String(options.min_confidence));
+    if (options.q)
+      params.set("q", options.q);
+    if (options.limit !== undefined)
+      params.set("limit", String(options.limit));
+    if (options.offset !== undefined)
+      params.set("offset", String(options.offset));
+    return this.requestRaw("GET", `/memory/entities?${params.toString()}`, undefined, {
+      accept: "text/markdown"
+    });
+  }
+  async getMemoryEntityMarkdown(entityId) {
+    return this.requestRaw("GET", `/memory/entities/${entityId}`, undefined, {
+      accept: "text/markdown"
+    });
+  }
+  async searchMemoryEntitiesMarkdown(workspaceId, query, options) {
+    const params = new URLSearchParams;
+    params.set("workspace_id", workspaceId);
+    params.set("q", query);
+    if (options?.project_id)
+      params.set("project_id", options.project_id);
+    if (options?.type)
+      params.set("type", options.type);
+    if (options?.limit !== undefined)
+      params.set("limit", String(options.limit));
+    return this.requestRaw("GET", `/memory/search?${params.toString()}`, undefined, {
+      accept: "text/markdown"
+    });
+  }
   async processNLU(data) {
     return this.request("POST", "/nlu", data);
   }
@@ -31295,7 +31399,12 @@ var TOOLS = {
             "pattern",
             "error",
             "solution",
-            "preference"
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
           ],
           description: "Entity type (default: context)"
         },
@@ -31344,7 +31453,12 @@ var TOOLS = {
             "pattern",
             "error",
             "solution",
-            "preference"
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
           ],
           description: "Filter by entity type"
         },
@@ -31378,6 +31492,58 @@ var TOOLS = {
       }
     }
   },
+  harmony_update_memory: {
+    description: "Update an existing memory entity. Can change title, content, tags, confidence, scope, type, or metadata.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entityId: {
+          type: "string",
+          description: "Memory entity UUID to update"
+        },
+        title: { type: "string", description: "New title" },
+        content: { type: "string", description: "New content (markdown body)" },
+        type: {
+          type: "string",
+          enum: [
+            "agent",
+            "task",
+            "decision",
+            "context",
+            "pattern",
+            "error",
+            "solution",
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
+          ],
+          description: "New entity type"
+        },
+        scope: {
+          type: "string",
+          enum: ["private", "project", "workspace", "global"],
+          description: "New visibility scope"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "New tags (replaces existing)"
+        },
+        confidence: {
+          type: "number",
+          description: "New confidence score 0-1"
+        },
+        metadata: {
+          type: "object",
+          description: "New metadata (merged with existing)"
+        }
+      },
+      required: ["entityId"]
+    }
+  },
   harmony_forget: {
     description: "Archive or delete a memory entity by ID.",
     inputSchema: {
@@ -31444,7 +31610,12 @@ var TOOLS = {
             "pattern",
             "error",
             "solution",
-            "preference"
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
           ],
           description: "Filter results by entity type"
         },
@@ -31567,8 +31738,9 @@ class HarmonyMCPServer {
       const { name, arguments: args } = request.params;
       try {
         const result = await this.handleToolCall(name, args || {});
+        const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
         return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+          content: [{ type: "text", text }]
         };
       } catch (error48) {
         return {
@@ -32035,7 +32207,7 @@ class HarmonyMCPServer {
         if (!workspaceId) {
           throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
         }
-        const result = await client2.listMemoryEntities({
+        const markdown = await client2.listMemoryEntitiesMarkdown({
           workspace_id: workspaceId,
           project_id: args.projectId || getActiveProjectId() || undefined,
           type: args.type,
@@ -32045,6 +32217,26 @@ class HarmonyMCPServer {
           q: args.query,
           limit: args.limit
         });
+        return markdown || "No memories found.";
+      }
+      case "harmony_update_memory": {
+        const entityId = exports_external.string().uuid().parse(args.entityId);
+        const updates = {};
+        if (args.title !== undefined)
+          updates.title = args.title;
+        if (args.content !== undefined)
+          updates.content = args.content;
+        if (args.type !== undefined)
+          updates.type = args.type;
+        if (args.scope !== undefined)
+          updates.scope = args.scope;
+        if (args.tags !== undefined)
+          updates.tags = args.tags;
+        if (args.confidence !== undefined)
+          updates.confidence = args.confidence;
+        if (args.metadata !== undefined)
+          updates.metadata = args.metadata;
+        const result = await client2.updateMemoryEntity(entityId, updates);
         return { success: true, ...result };
       }
       case "harmony_forget": {
@@ -32078,12 +32270,12 @@ class HarmonyMCPServer {
         if (!workspaceId) {
           throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
         }
-        const result = await client2.searchMemoryEntities(workspaceId, query, {
+        const markdown = await client2.searchMemoryEntitiesMarkdown(workspaceId, query, {
           project_id: args.projectId || getActiveProjectId() || undefined,
           type: args.type,
           limit: args.limit
         });
-        return { success: true, ...result };
+        return markdown || "No memories found.";
       }
       case "harmony_create_plan": {
         const title = exports_external.string().min(1).parse(args.title);

package/dist/index.js

@@ -27976,37 +27976,50 @@ class HarmonyApiClient {
     this.apiKey = getApiKey();
     this.apiUrl = getApiUrl();
   }
-  async request(method, path, body) {
+  async request(method, path, body, options) {
     await requestSemaphore.acquire();
     try {
-      return await this.requestWithRetry(method, path, body);
+      return await this.requestWithRetry(method, path, body, options);
     } finally {
       requestSemaphore.release();
     }
   }
-  async requestWithRetry(method, path, body) {
+  async requestRaw(method, path, body, options) {
+    await requestSemaphore.acquire();
+    try {
+      return await this.requestRawWithRetry(method, path, body, options);
+    } finally {
+      requestSemaphore.release();
+    }
+  }
+  async requestWithRetry(method, path, body, options) {
     const url2 = `${this.apiUrl}/v1${path}`;
     let lastError = null;
+    const contentType = options?.contentType || "application/json";
+    const accept = options?.accept || "application/json";
     for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
       try {
         const response = await fetch(url2, {
           method,
           headers: {
-            "Content-Type": "application/json",
+            "Content-Type": contentType,
+            Accept: accept,
             "X-API-Key": this.apiKey
           },
-          body: body ? JSON.stringify(body) : undefined
+          body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
         });
         const data = await response.json();
         if (!response.ok) {
+          const errorMsg = data.error || `API error: ${response.status}`;
           if (!isRetryableError(null, response.status)) {
-            throw new Error(data.error || `API error: ${response.status}`);
+            throw new Error(errorMsg);
           }
-          lastError = new Error(data.error || `API error: ${response.status}`);
+          lastError = new Error(errorMsg);
           if (attempt < RETRY_CONFIG.maxRetries) {
             await sleep(getRetryDelay(attempt));
             continue;
           }
+          throw lastError;
         }
         return data;
       } catch (error48) {
@@ -28021,6 +28034,53 @@ class HarmonyApiClient {
     }
     throw lastError || new Error("Request failed after retries");
   }
+  async requestRawWithRetry(method, path, body, options) {
+    const url2 = `${this.apiUrl}/v1${path}`;
+    let lastError = null;
+    const contentType = options?.contentType || "application/json";
+    const accept = options?.accept || "text/markdown";
+    for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+      try {
+        const response = await fetch(url2, {
+          method,
+          headers: {
+            "Content-Type": contentType,
+            Accept: accept,
+            "X-API-Key": this.apiKey
+          },
+          body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
+        });
+        if (!response.ok) {
+          const text = await response.text();
+          let errorMsg;
+          try {
+            errorMsg = JSON.parse(text).error || `API error: ${response.status}`;
+          } catch {
+            errorMsg = text || `API error: ${response.status}`;
+          }
+          if (!isRetryableError(null, response.status)) {
+            throw new Error(errorMsg);
+          }
+          lastError = new Error(errorMsg);
+          if (attempt < RETRY_CONFIG.maxRetries) {
+            await sleep(getRetryDelay(attempt));
+            continue;
+          }
+          throw lastError;
+        }
+        return await response.text();
+      } catch (error48) {
+        lastError = error48 instanceof Error ? error48 : new Error(String(error48));
+        if (!isRetryableError(error48))
+          throw lastError;
+        if (attempt < RETRY_CONFIG.maxRetries) {
+          await sleep(getRetryDelay(attempt));
+          continue;
+        }
+      }
+    }
+    throw lastError || new Error("Request failed after retries");
+  }
   async listWorkspaces() {
     return this.request("GET", "/workspaces");
   }
@@ -28182,6 +28242,50 @@ class HarmonyApiClient {
       params.set("limit", String(options.limit));
     return this.request("GET", `/memory/search?${params.toString()}`);
   }
+  async listMemoryEntitiesMarkdown(options) {
+    const params = new URLSearchParams;
+    params.set("workspace_id", options.workspace_id);
+    if (options.project_id)
+      params.set("project_id", options.project_id);
+    if (options.type)
+      params.set("type", options.type);
+    if (options.scope)
+      params.set("scope", options.scope);
+    if (options.tags?.length)
+      params.set("tags", options.tags.join(","));
+    if (options.agent_identifier)
+      params.set("agent_identifier", options.agent_identifier);
+    if (options.min_confidence !== undefined)
+      params.set("min_confidence", String(options.min_confidence));
+    if (options.q)
+      params.set("q", options.q);
+    if (options.limit !== undefined)
+      params.set("limit", String(options.limit));
+    if (options.offset !== undefined)
+      params.set("offset", String(options.offset));
+    return this.requestRaw("GET", `/memory/entities?${params.toString()}`, undefined, {
+      accept: "text/markdown"
+    });
+  }
+  async getMemoryEntityMarkdown(entityId) {
+    return this.requestRaw("GET", `/memory/entities/${entityId}`, undefined, {
+      accept: "text/markdown"
+    });
+  }
+  async searchMemoryEntitiesMarkdown(workspaceId, query, options) {
+    const params = new URLSearchParams;
+    params.set("workspace_id", workspaceId);
+    params.set("q", query);
+    if (options?.project_id)
+      params.set("project_id", options.project_id);
+    if (options?.type)
+      params.set("type", options.type);
+    if (options?.limit !== undefined)
+      params.set("limit", String(options.limit));
+    return this.requestRaw("GET", `/memory/search?${params.toString()}`, undefined, {
+      accept: "text/markdown"
+    });
+  }
   async processNLU(data) {
     return this.request("POST", "/nlu", data);
   }
@@ -29055,7 +29159,12 @@ var TOOLS = {
             "pattern",
             "error",
             "solution",
-            "preference"
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
           ],
           description: "Entity type (default: context)"
         },
@@ -29104,7 +29213,12 @@ var TOOLS = {
             "pattern",
             "error",
             "solution",
-            "preference"
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
           ],
           description: "Filter by entity type"
         },
@@ -29138,6 +29252,58 @@ var TOOLS = {
       }
     }
   },
+  harmony_update_memory: {
+    description: "Update an existing memory entity. Can change title, content, tags, confidence, scope, type, or metadata.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entityId: {
+          type: "string",
+          description: "Memory entity UUID to update"
+        },
+        title: { type: "string", description: "New title" },
+        content: { type: "string", description: "New content (markdown body)" },
+        type: {
+          type: "string",
+          enum: [
+            "agent",
+            "task",
+            "decision",
+            "context",
+            "pattern",
+            "error",
+            "solution",
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
+          ],
+          description: "New entity type"
+        },
+        scope: {
+          type: "string",
+          enum: ["private", "project", "workspace", "global"],
+          description: "New visibility scope"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "New tags (replaces existing)"
+        },
+        confidence: {
+          type: "number",
+          description: "New confidence score 0-1"
+        },
+        metadata: {
+          type: "object",
+          description: "New metadata (merged with existing)"
+        }
+      },
+      required: ["entityId"]
+    }
+  },
   harmony_forget: {
     description: "Archive or delete a memory entity by ID.",
     inputSchema: {
@@ -29204,7 +29370,12 @@ var TOOLS = {
             "pattern",
             "error",
             "solution",
-            "preference"
+            "preference",
+            "relationship",
+            "commitment",
+            "lesson",
+            "project",
+            "handoff"
           ],
           description: "Filter results by entity type"
         },
@@ -29327,8 +29498,9 @@ class HarmonyMCPServer {
       const { name, arguments: args } = request.params;
       try {
         const result = await this.handleToolCall(name, args || {});
+        const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
         return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+          content: [{ type: "text", text }]
         };
       } catch (error48) {
         return {
@@ -29795,7 +29967,7 @@ class HarmonyMCPServer {
         if (!workspaceId) {
           throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
         }
-        const result = await client2.listMemoryEntities({
+        const markdown = await client2.listMemoryEntitiesMarkdown({
           workspace_id: workspaceId,
           project_id: args.projectId || getActiveProjectId() || undefined,
           type: args.type,
@@ -29805,6 +29977,26 @@ class HarmonyMCPServer {
           q: args.query,
           limit: args.limit
         });
+        return markdown || "No memories found.";
+      }
+      case "harmony_update_memory": {
+        const entityId = exports_external.string().uuid().parse(args.entityId);
+        const updates = {};
+        if (args.title !== undefined)
+          updates.title = args.title;
+        if (args.content !== undefined)
+          updates.content = args.content;
+        if (args.type !== undefined)
+          updates.type = args.type;
+        if (args.scope !== undefined)
+          updates.scope = args.scope;
+        if (args.tags !== undefined)
+          updates.tags = args.tags;
+        if (args.confidence !== undefined)
+          updates.confidence = args.confidence;
+        if (args.metadata !== undefined)
+          updates.metadata = args.metadata;
+        const result = await client2.updateMemoryEntity(entityId, updates);
         return { success: true, ...result };
       }
       case "harmony_forget": {
@@ -29838,12 +30030,12 @@ class HarmonyMCPServer {
         if (!workspaceId) {
           throw new Error("No workspace specified. Use harmony_set_workspace_context or provide workspaceId.");
         }
-        const result = await client2.searchMemoryEntities(workspaceId, query, {
+        const markdown = await client2.searchMemoryEntitiesMarkdown(workspaceId, query, {
           project_id: args.projectId || getActiveProjectId() || undefined,
           type: args.type,
           limit: args.limit
         });
-        return { success: true, ...result };
+        return markdown || "No memories found.";
       }
       case "harmony_create_plan": {
         const title = exports_external.string().min(1).parse(args.title);

package/package.json

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