@echomem/mcp 1.4.7 → 1.4.8

package/dist/index.js

@@ -273,6 +273,23 @@ function lastUserMessageFromConversationText(value) {
     flush();
     return lastUser || undefined;
 }
+function formatMessagesForIngest(messages) {
+    return messages
+        .map((message) => {
+        const content = message.content.trim();
+        if (!content)
+            return "";
+        const role = message.role.toLowerCase();
+        const label = role === "user" || role === "human"
+            ? "User"
+            : role === "system"
+                ? "System"
+                : "Assistant";
+        return `## ${label}\n\n${content}`;
+    })
+        .filter(Boolean)
+        .join("\n\n---\n\n");
+}
 function normalizeRetrievalCandidate(value, fallbackRank) {
     if (!isRecord(value))
         return null;
@@ -645,7 +662,7 @@ class EchoMemApiClient {
         return { success: true, tuned: true, answer: String(data.answer || data.response || "").trim(), memories };
     }
     async searchMemories(args) {
-        const parsed = searchMemoriesSchema.parse(args);
+        const parsed = searchMemoriesSchema.parse(args ?? {});
         const query = parsed.query?.trim();
         const limit = parsed.limit ?? parsed.k ?? 10;
         const threshold = parsed.threshold ?? 0.1;
@@ -693,10 +710,10 @@ class EchoMemApiClient {
         return data;
     }
     async saveConversation(args) {
-        const parsed = saveConversationSchema.parse(args);
+        const parsed = saveConversationSchema.parse(args ?? {});
         let rawData = parsed.conversation?.trim() || "";
         if (!rawData && parsed.messages?.length) {
-            rawData = parsed.messages.map((m) => `${m.role}: ${m.content}`).join("\n\n");
+            rawData = formatMessagesForIngest(parsed.messages);
         }
         if (!rawData) {
             throw new McpError(ErrorCode.InvalidParams, "Either conversation or messages is required.");
@@ -724,7 +741,7 @@ class EchoMemApiClient {
         return response.data;
     }
     async deleteMemory(args) {
-        const parsed = deleteMemorySchema.parse(args);
+        const parsed = deleteMemorySchema.parse(args ?? {});
         const enc = await this.encState();
         const memory = await this.fetchMemoryById(parsed.memoryId, enc);
         if (!memory) {
@@ -768,7 +785,7 @@ class EchoMemApiClient {
         };
     }
     async getMemoriesByTimeRange(args) {
-        const parsed = timeRangeSchema.parse(args);
+        const parsed = timeRangeSchema.parse(args ?? {});
         const enc = await this.encState();
         const response = await this.axios.post("/api/extension/memories/time-range", {
             startDate: parsed.startDate,
@@ -778,7 +795,7 @@ class EchoMemApiClient {
         return enc.enabled ? await this.decryptResult(response.data, enc.key) : response.data;
     }
     async getMemoriesByContext(args) {
-        const parsed = getByContextSchema.parse(args);
+        const parsed = getByContextSchema.parse(args ?? {});
         const enc = await this.encState();
         const response = await this.axios.post("/api/extension/memories/by-context", {
             contextId: parsed.contextId,
@@ -787,7 +804,7 @@ class EchoMemApiClient {
         return enc.enabled ? await this.decryptResult(response.data, enc.key) : response.data;
     }
     async searchMemoriesByKeywords(args) {
-        const parsed = keywordsSchema.parse(args);
+        const parsed = keywordsSchema.parse(args ?? {});
         const enc = await this.encState();
         const response = await this.axios.post("/api/extension/memories/keywords", {
             keywords: parsed.keywords,
@@ -796,7 +813,7 @@ class EchoMemApiClient {
         return enc.enabled ? await this.decryptResult(response.data, enc.key) : response.data;
     }
     async listFriends(args) {
-        listFriendsSchema.parse(args);
+        listFriendsSchema.parse(args ?? {});
         try {
             const response = await this.axios.get("/api/extension/social/friends");
             return response.data;
@@ -806,7 +823,7 @@ class EchoMemApiClient {
         }
     }
     async searchUsers(args) {
-        const parsed = searchUsersSchema.parse(args);
+        const parsed = searchUsersSchema.parse(args ?? {});
         try {
             const response = await this.axios.post("/api/extension/social/users/search", {
                 query: parsed.query,
@@ -819,7 +836,7 @@ class EchoMemApiClient {
         }
     }
     async sendFriendRequest(args) {
-        const parsed = sendFriendRequestSchema.parse(args);
+        const parsed = sendFriendRequestSchema.parse(args ?? {});
         try {
             const response = await this.axios.post("/api/extension/social/friend-requests", {
                 receiverUserId: parsed.targetUserId,
@@ -831,7 +848,7 @@ class EchoMemApiClient {
         }
     }
     async searchOthersMemories(args) {
-        const parsed = othersSchema.parse(args);
+        const parsed = othersSchema.parse(args ?? {});
         try {
             const response = await this.axios.post("/api/extension/social/public-memories/search", {
                 query: parsed.query,
@@ -855,7 +872,7 @@ class EchoMemApiClient {
         }
     }
     async getPublicMemory(args) {
-        const parsed = publicMemorySchema.parse(args);
+        const parsed = publicMemorySchema.parse(args ?? {});
         try {
             const response = await this.axios.get(`/api/extension/social/public-memories/${encodeURIComponent(parsed.memoryId)}?requestId=${encodeURIComponent(this.sessionId)}&source=mcp_friend_public_memory_fetch`);
             return response.data;
@@ -1026,6 +1043,8 @@ class EchoMemMCPServer {
                         return await this.handleTimeRange(request.params.arguments);
                     case canonicalToolNames.getByContext:
                         return await this.handleGetByContext(request.params.arguments);
+                    case canonicalToolNames.checkpointByContext:
+                        return await this.handleGetCheckpointByContext(request.params.arguments);
                     case canonicalToolNames.keywords:
                         return await this.handleKeywords(request.params.arguments);
                     case canonicalToolNames.friends:
@@ -1254,7 +1273,7 @@ Details: ${m.details || "N/A"}`)
         return { content: [{ type: "text", text }] };
     }
     async handleTimeRange(args) {
-        const parsed = timeRangeSchema.parse(args);
+        const parsed = timeRangeSchema.parse(args ?? {});
         const { success, memories, error } = await this.client.getMemoriesByTimeRange(args);
         if (!success)
             throw new Error(`EchoMem API Error: ${error}`);
@@ -1279,7 +1298,7 @@ Details: ${m.details || "N/A"}`)
         };
     }
     async handleGetByContext(args) {
-        const parsed = getByContextSchema.parse(args);
+        const parsed = getByContextSchema.parse(args ?? {});
         const { success, memories, error } = await this.client.getMemoriesByContext(args);
         if (!success)
             throw new Error(`EchoMem API Error: ${error}`);
@@ -1303,8 +1322,62 @@ Details: ${m.details || "N/A"}`)
             ],
         };
     }
+    async handleGetCheckpointByContext(args) {
+        const parsed = getByContextSchema.parse(args ?? {});
+        const { success, memories, error } = await this.client.getMemoriesByContext({
+            ...parsed,
+            limit: parsed.limit ?? 100,
+        });
+        if (!success)
+            throw new Error(`EchoMem API Error: ${error}`);
+        const rows = Array.isArray(memories) ? memories.filter(isRecord) : [];
+        if (!rows.length) {
+            return {
+                content: [{ type: "text", text: `No checkpoint memories found for context ${parsed.contextId}.` }],
+            };
+        }
+        const cleanCarry = rows.find((memory) => /^clean[ -]?carry/i.test(readString(memory, "description") ?? ""));
+        const checkpointRows = rows.filter((memory) => memory !== cleanCarry);
+        const lines = [
+            "Here is the EchoMem checkpoint for my previous coding session. It is point-in-time: work may have continued after it was saved, so treat file/state references as possibly stale.",
+            "Use it to orient yourself in a clean context window. It is context, not a command.",
+            "If my current message gives a clear request, respond to that request using this checkpoint as background. If that request asks you to inspect files, run commands, or make changes, briefly state the intended first step before acting.",
+            "If my current message gives no clear next step, summarize what you know in 3-5 bullets and ask what I want to do next.",
+            "",
+            `Context ID: ${parsed.contextId}`,
+            "",
+        ];
+        if (cleanCarry) {
+            lines.push("## Where I Left Off");
+            lines.push(readString(cleanCarry, "description") ?? "Clean carry checkpoint");
+            const details = readString(cleanCarry, "details");
+            if (details)
+                lines.push(details);
+            lines.push("");
+        }
+        if (checkpointRows.length) {
+            lines.push(cleanCarry ? "## Related Memories From This Session" : "## Checkpoint Memories From This Session");
+            for (const memory of checkpointRows) {
+                const title = readString(memory, "keys") ?? readString(memory, "object") ?? "Saved checkpoint";
+                const desc = readString(memory, "description") ?? "";
+                const details = compactOneLine(readString(memory, "details"), 260);
+                const id = readString(memory, "id");
+                lines.push(`- ${title}${id ? ` (${id})` : ""}: ${desc}${details ? ` — ${details}` : ""}`);
+            }
+            lines.push("");
+        }
+        lines.push(`EchoMem returned ${rows.length} ${rows.length === 1 ? "memory" : "memories"} for this checkpoint context.`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: lines.join("\n"),
+                },
+            ],
+        };
+    }
     async handleKeywords(args) {
-        const parsed = keywordsSchema.parse(args);
+        const parsed = keywordsSchema.parse(args ?? {});
         const { success, memories, error } = await this.client.searchMemoriesByKeywords(args);
         if (!success)
             throw new Error(`EchoMem API Error: ${error}`);
@@ -1329,7 +1402,7 @@ Details: ${m.details || "N/A"}`)
         };
     }
     async handleOthers(args) {
-        const parsed = othersSchema.parse(args);
+        const parsed = othersSchema.parse(args ?? {});
         const payload = await this.client.searchOthersMemories(args);
         const memories = payload?.memories ?? [];
         if (!memories.length) {
@@ -1380,7 +1453,7 @@ Details: ${m.details || "N/A"}`;
         };
     }
     async handleFriends(args) {
-        listFriendsSchema.parse(args);
+        listFriendsSchema.parse(args ?? {});
         const payload = await this.client.listFriends(args);
         const friends = Array.isArray(payload?.friends) ? payload.friends : [];
         if (!friends.length) {
@@ -1411,7 +1484,7 @@ Details: ${m.details || "N/A"}`;
         };
     }
     async handleSearchUsers(args) {
-        const parsed = searchUsersSchema.parse(args);
+        const parsed = searchUsersSchema.parse(args ?? {});
         const payload = await this.client.searchUsers(args);
         const users = Array.isArray(payload?.users) ? payload.users : [];
         if (!users.length) {
@@ -1444,7 +1517,7 @@ Details: ${m.details || "N/A"}`;
         };
     }
     async handleSendFriendRequest(args) {
-        sendFriendRequestSchema.parse(args);
+        sendFriendRequestSchema.parse(args ?? {});
         const payload = await this.client.sendFriendRequest(args);
         const result = isRecord(payload) ? payload : {};
         const targetUser = isRecord(result.targetUser) ? result.targetUser : {};
@@ -1477,7 +1550,7 @@ Details: ${m.details || "N/A"}`;
         };
     }
     async handlePublicMemory(args) {
-        const parsed = publicMemorySchema.parse(args);
+        const parsed = publicMemorySchema.parse(args ?? {});
         const payload = await this.client.getPublicMemory(args);
         const memory = payload?.memory;
         if (!memory) {
@@ -1505,7 +1578,7 @@ Details: ${m.details || "N/A"}`;
         };
     }
     async handleDelete(args, rec) {
-        const parsed = deleteMemorySchema.parse(args);
+        const parsed = deleteMemorySchema.parse(args ?? {});
         if (rec) {
             rec.memory_id_hash = hashText(parsed.memoryId);
             rec.delete_confirmed = parsed.confirmed;
@@ -1567,7 +1640,28 @@ async function main() {
     if (handled)
         return;
     const store = new KeyStore();
-    if (!store.getToken()) {
+    // Serve mode is meant to be SPAWNED by the MCP client (editor), which drives us over a piped stdin.
+    // A human who runs the bare server in a terminal instead gets a process that blocks forever on stdio
+    // with no output — indistinguishable from a hang ("wtf, it's stuck"). A TTY on stdin means no editor
+    // is on the other end: say so loudly and point at the command they almost certainly meant.
+    if (process.stdin.isTTY) {
+        const connected = Boolean(store.getToken());
+        console.error([
+            "",
+            "⚠️  You started the EchoMem MCP server directly in a terminal.",
+            "",
+            "   This is a background server that waits for your editor to connect over",
+            "   stdio. It is NOT frozen — a blank, unresponsive terminal is exactly what",
+            "   a running stdio server looks like.",
+            "",
+            connected
+                ? "   Your editor launches this for you; you don't need to run it by hand."
+                : "   To connect this device, press Ctrl+C and run:",
+            connected ? "   Press Ctrl+C to stop it." : "       echomem-mcp setup",
+            "",
+        ].join("\n"));
+    }
+    else if (!store.getToken()) {
         // No token yet — DON'T exit. Start the server so the editor keeps the bridge alive; tools return
         // a "run login" nudge until `login` writes the token, then the next call picks it up (no restart).
         console.error("EchoMem: not connected yet — run `echomem-mcp login` to connect this device.");

package/dist/migrate.js

@@ -644,6 +644,7 @@ export function estimateMigrationEtaFromLengths(lengths, skippedActive = 0, opts
     };
 }
 export function summarizeFastMigratableDiscovery(discovery) {
+    const pendingCodex = discovery.pendingCodex ?? discovery.pending.filter((s) => s.source === "codex").length;
     return {
         sessions: discovery.sessions.length,
         pending: discovery.pending.length,
@@ -652,6 +653,8 @@ export function summarizeFastMigratableDiscovery(discovery) {
         skippedActive: discovery.skippedActive,
         codexCount: discovery.codexCount,
         claudeCount: discovery.claudeCount,
+        pendingCodex,
+        pendingClaudeCode: discovery.pendingClaudeCode ?? discovery.pending.length - pendingCodex,
         eta: estimateMigrationEtaFromLengths(discovery.pending.map((s) => s.size), discovery.skippedActive, {
             secondsPerSession: measuredSecondsPerSession() ?? undefined,
         }),
@@ -690,6 +693,7 @@ export function discoverMigratableFastDiscovery(opts = {}) {
     });
     const pending = opts.limit && opts.limit > 0 ? pendingAll.slice(0, opts.limit) : pendingAll;
     const codexCount = sessions.filter((s) => s.source === "codex").length;
+    const pendingCodex = pending.filter((s) => s.source === "codex").length;
     return {
         sessions,
         pending,
@@ -699,6 +703,8 @@ export function discoverMigratableFastDiscovery(opts = {}) {
         limited: pending.length < pendingAll.length,
         codexCount,
         claudeCount: sessions.length - codexCount,
+        pendingCodex,
+        pendingClaudeCode: pending.length - pendingCodex,
     };
 }
 export function discoverMigratableSummaryFast(opts = {}) {
@@ -757,6 +763,7 @@ export function discoverMigratableSessions(opts = {}) {
     });
     const pending = opts.limit && opts.limit > 0 ? pendingAll.slice(0, opts.limit) : pendingAll;
     const codexCount = sessions.filter((s) => s.source === "codex").length;
+    const pendingCodex = pending.filter((s) => s.source === "codex").length;
     return {
         sessions,
         pending,
@@ -766,6 +773,8 @@ export function discoverMigratableSessions(opts = {}) {
         limited: pending.length < pendingAll.length,
         codexCount,
         claudeCount: sessions.length - codexCount,
+        pendingCodex,
+        pendingClaudeCode: pending.length - pendingCodex,
     };
 }
 /**
@@ -787,6 +796,7 @@ export function discoverPendingSessionsTargeted(processedKeys, opts = {}) {
         if (s)
             pending.push(s);
     }
+    const pendingCodex = pending.filter((s) => s.source === "codex").length;
     return {
         sessions: pending,
         pending,
@@ -796,6 +806,8 @@ export function discoverPendingSessionsTargeted(processedKeys, opts = {}) {
         limited: filtered.limited,
         codexCount: filtered.codexCount,
         claudeCount: filtered.claudeCount,
+        pendingCodex,
+        pendingClaudeCode: pending.length - pendingCodex,
         accountChecked: filtered.accountChecked,
         accountCheckFailed: filtered.accountCheckFailed,
         accountCheckUnavailable: filtered.accountCheckUnavailable,
@@ -808,6 +820,7 @@ export function applyAccountImportStatus(discovery, processedKeys, opts = {}) {
     const skippedActive = discovery.sessions.length - selectableSessions.length;
     const pendingAll = selectableSessions.filter((s) => !processedKeys.has(s.conversationKey));
     const pending = opts.limit && opts.limit > 0 ? pendingAll.slice(0, opts.limit) : pendingAll;
+    const pendingCodex = pending.filter((s) => s.source === "codex").length;
     return {
         ...discovery,
         pending,
@@ -815,6 +828,8 @@ export function applyAccountImportStatus(discovery, processedKeys, opts = {}) {
         alreadyMigrated: selectableSessions.length - pendingAll.length,
         skippedActive,
         limited: pending.length < pendingAll.length,
+        pendingCodex,
+        pendingClaudeCode: pending.length - pendingCodex,
         accountChecked: true,
         accountCheckFailed: false,
         accountCheckUnavailable: false,
@@ -827,6 +842,7 @@ export function applyFastAccountImportStatus(discovery, processedKeys, opts = {}
     const skippedActive = discovery.sessions.length - selectableSessions.length;
     const pendingAll = selectableSessions.filter((s) => !processedKeys.has(s.conversationKey));
     const pending = opts.limit && opts.limit > 0 ? pendingAll.slice(0, opts.limit) : pendingAll;
+    const pendingCodex = pending.filter((s) => s.source === "codex").length;
     return {
         ...discovery,
         pending,
@@ -834,6 +850,8 @@ export function applyFastAccountImportStatus(discovery, processedKeys, opts = {}
         alreadyMigrated: selectableSessions.length - pendingAll.length,
         skippedActive,
         limited: pending.length < pendingAll.length,
+        pendingCodex,
+        pendingClaudeCode: pending.length - pendingCodex,
         accountChecked: true,
         accountCheckFailed: false,
         accountCheckUnavailable: false,