devsh-memory-mcp 0.3.8 → 0.3.9

package/dist/{chunk-BKOJ5TNO.js → chunk-4CUOHQV6.js}

@@ -184,7 +184,7 @@ function createMemoryMcpServer(config) {
     tools: [
       {
         name: "read_memory",
-        description: 'Read a memory file. Type can be "knowledge", "tasks", or "mailbox".',
+        description: 'Read a memory file. Type can be "knowledge", "tasks", or "mailbox". For tasks, by default only returns open tasks (pending/in_progress) to prevent context bloat.',
         inputSchema: {
           type: "object",
           properties: {
@@ -192,6 +192,14 @@ function createMemoryMcpServer(config) {
               type: "string",
               enum: ["knowledge", "tasks", "mailbox"],
               description: "The type of memory to read"
+            },
+            includeCompleted: {
+              type: "boolean",
+              description: "For tasks: include completed tasks (default: false, only open tasks)"
+            },
+            limit: {
+              type: "number",
+              description: "For tasks: maximum number of tasks to return (default: 50)"
             }
           },
           required: ["type"]
@@ -235,7 +243,7 @@ function createMemoryMcpServer(config) {
       },
       {
         name: "send_message",
-        description: 'Send a message to another agent on the same task. Use "*" to broadcast to all agents.',
+        description: 'Send a message to another agent on the same task. Use "*" to broadcast to all agents. Aligned with Claude Code SendMessage pattern.',
         inputSchema: {
           type: "object",
           properties: {
@@ -249,8 +257,25 @@ function createMemoryMcpServer(config) {
             },
             type: {
               type: "string",
-              enum: ["handoff", "request", "status"],
-              description: "Message type: handoff (work transfer), request (ask to do something), status (progress update)"
+              enum: ["handoff", "request", "status", "response"],
+              description: "Message type: handoff (work transfer), request (ask to do something), status (progress update), response (reply to a request)"
+            },
+            correlationId: {
+              type: "string",
+              description: "Optional correlation ID for request-response tracking. Use to link related messages."
+            },
+            replyTo: {
+              type: "string",
+              description: "Optional message ID this is responding to (for response type messages)."
+            },
+            priority: {
+              type: "string",
+              enum: ["high", "normal", "low"],
+              description: "Message priority (default: normal). High priority messages appear first."
+            },
+            metadata: {
+              type: "object",
+              description: "Optional additional context as key-value pairs."
             }
           },
           required: ["to", "message"]
@@ -258,13 +283,22 @@ function createMemoryMcpServer(config) {
       },
       {
         name: "get_my_messages",
-        description: "Get all messages addressed to this agent (including broadcasts). Returns unread messages first.",
+        description: "Get all messages addressed to this agent (including broadcasts). Returns high-priority and unread messages first.",
         inputSchema: {
           type: "object",
           properties: {
             includeRead: {
               type: "boolean",
               description: "Include messages already marked as read (default: false)"
+            },
+            correlationId: {
+              type: "string",
+              description: "Filter messages by correlation ID (for tracking request-response chains)"
+            },
+            type: {
+              type: "string",
+              enum: ["handoff", "request", "status", "response"],
+              description: "Filter messages by type"
             }
           }
         }
@@ -723,12 +757,34 @@ function createMemoryMcpServer(config) {
     const { name, arguments: args } = request.params;
     switch (name) {
       case "read_memory": {
-        const type = args.type;
+        const { type, includeCompleted, limit } = args;
         let content = null;
         if (type === "knowledge") {
           content = readFile(path.join(knowledgeDir, "MEMORY.md"));
         } else if (type === "tasks") {
-          content = readFile(tasksPath);
+          const tasksFile = readTasks();
+          const maxTasks = limit ?? 50;
+          const showCompleted = includeCompleted ?? false;
+          let filteredTasks = showCompleted ? tasksFile.tasks : tasksFile.tasks.filter((t) => t.status === "pending" || t.status === "in_progress");
+          filteredTasks = filteredTasks.sort((a, b) => {
+            const aNum = parseInt(a.id.replace(/\D/g, ""), 10) || 0;
+            const bNum = parseInt(b.id.replace(/\D/g, ""), 10) || 0;
+            return bNum - aNum;
+          });
+          const truncated = filteredTasks.length > maxTasks;
+          filteredTasks = filteredTasks.slice(0, maxTasks);
+          const result = {
+            version: tasksFile.version,
+            tasks: filteredTasks,
+            _meta: {
+              totalTasks: tasksFile.tasks.length,
+              openTasks: tasksFile.tasks.filter((t) => t.status === "pending" || t.status === "in_progress").length,
+              returnedTasks: filteredTasks.length,
+              truncated,
+              includeCompleted: showCompleted
+            }
+          };
+          content = JSON.stringify(result, null, 2);
         } else if (type === "mailbox") {
           content = readFile(mailboxPath);
         }
@@ -759,7 +815,7 @@ function createMemoryMcpServer(config) {
         return { content: [{ type: "text", text: formatted }] };
       }
       case "send_message": {
-        const { to, message, type } = args;
+        const { to, message, type, correlationId, replyTo, priority, metadata } = args;
         const mailbox = readMailbox();
         const newMessage = {
           id: generateMessageId(),
@@ -768,23 +824,47 @@ function createMemoryMcpServer(config) {
           type: type ?? "request",
           message,
           timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-          read: false
+          read: false,
+          correlationId,
+          replyTo,
+          priority,
+          metadata
         };
         mailbox.messages.push(newMessage);
         writeMailbox(mailbox);
-        return { content: [{ type: "text", text: `Message sent successfully. ID: ${newMessage.id}` }] };
+        const responseText = correlationId ? `Message sent successfully. ID: ${newMessage.id}, correlationId: ${correlationId}` : `Message sent successfully. ID: ${newMessage.id}`;
+        return { content: [{ type: "text", text: responseText }] };
       }
       case "get_my_messages": {
-        const includeRead = args.includeRead ?? false;
+        const { includeRead, correlationId, type: filterType } = args;
         const mailbox = readMailbox();
-        const myMessages = mailbox.messages.filter(
+        let myMessages = mailbox.messages.filter(
           (m) => m.to === agentName || m.to === "*"
         );
-        const filtered = includeRead ? myMessages : myMessages.filter((m) => !m.read);
-        if (filtered.length === 0) {
+        if (!includeRead) {
+          myMessages = myMessages.filter((m) => !m.read);
+        }
+        if (correlationId) {
+          myMessages = myMessages.filter((m) => m.correlationId === correlationId);
+        }
+        if (filterType) {
+          myMessages = myMessages.filter((m) => m.type === filterType);
+        }
+        const priorityOrder = { high: 0, normal: 1, low: 2, undefined: 1 };
+        myMessages.sort((a, b) => {
+          const pa = priorityOrder[a.priority ?? "normal"];
+          const pb = priorityOrder[b.priority ?? "normal"];
+          if (pa !== pb) return pa - pb;
+          return new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime();
+        });
+        if (myMessages.length === 0) {
           return { content: [{ type: "text", text: "No messages for you." }] };
         }
-        const formatted = filtered.map((m) => `[${m.id}] ${m.type ?? "message"} from ${m.from}: ${m.message}`).join("\n\n");
+        const formatted = myMessages.map((m) => {
+          const priorityTag = m.priority === "high" ? "[HIGH] " : m.priority === "low" ? "[low] " : "";
+          const corrTag = m.correlationId ? ` (corr: ${m.correlationId})` : "";
+          return `${priorityTag}[${m.id}] ${m.type ?? "message"} from ${m.from}${corrTag}: ${m.message}`;
+        }).join("\n\n");
         return { content: [{ type: "text", text: formatted }] };
       }
       case "mark_read": {

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runServer
-} from "./chunk-BKOJ5TNO.js";
+} from "./chunk-4CUOHQV6.js";
 
 // src/cli.ts
 function parseArgs() {

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createMemoryMcpServer,
   runServer
-} from "./chunk-BKOJ5TNO.js";
+} from "./chunk-4CUOHQV6.js";
 export {
   createMemoryMcpServer,
   runServer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devsh-memory-mcp",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "MCP server for devsh/cmux agent memory - enables Claude Desktop and external clients to access sandbox memory and orchestrate multi-agent workflows",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "test": "bun test",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },