@echomem/mcp 1.4.16 → 1.4.18

package/dist/index.js

@@ -126,10 +126,13 @@ function formatUpgradeRequiredResult(error) {
         pricingUrl,
     });
     return [
+        "ACTION REQUIRED: tell the user to start a 7-day Pro trial or choose a subscription at this exact URL:",
+        pricingUrl,
+        "When replying, include the exact URL above. Do not reply only with \"connect\" or \"upgrade\".",
+        "",
         message,
         "",
         code ? `Reason: ${code}.` : "",
-        `Open pricing: ${pricingUrl}`,
     ].filter(Boolean).join("\n");
 }
 /** Map a thrown error to the telemetry error_kind taxonomy. */

package/dist/migrate.js

@@ -984,6 +984,7 @@ export async function startMigration(opts) {
         userTz: tz,
         encKey,
         onProgress: opts.onProgress,
+        shouldStop: opts.shouldStop,
         runId,
         metricsFile,
         selection: opts.selection,
@@ -993,20 +994,30 @@ export async function startMigration(opts) {
 async function runJobs(args) {
     const ledger = loadLedger();
     const reqTimes = [];
+    let migrated = 0, extracted = 0, failed = 0, done = 0;
+    let stoppedReason;
+    const stopIfRequested = () => {
+        if (args.shouldStop?.()) {
+            stoppedReason = "paused";
+            return true;
+        }
+        return false;
+    };
     const throttle = async () => {
         for (;;) {
+            if (stopIfRequested())
+                return false;
             const now = Date.now();
             while (reqTimes.length && now - reqTimes[0] > RATE_WINDOW_MS)
                 reqTimes.shift();
             if (reqTimes.length < RATE_MAX) {
                 reqTimes.push(Date.now());
-                return;
+                return true;
             }
-            await sleep(RATE_WINDOW_MS - (now - reqTimes[0]) + 100);
+            // Check a pause request promptly instead of making the user wait for the rate window.
+            await sleep(Math.min(250, RATE_WINDOW_MS - (now - reqTimes[0]) + 100));
         }
     };
-    let migrated = 0, extracted = 0, failed = 0, done = 0;
-    let stoppedReason;
     const total = args.session.jobs.length;
     const recordMetric = (metric) => {
         try {
@@ -1021,8 +1032,9 @@ async function runJobs(args) {
     const runOne = async (job, s) => {
         const jobStartedAt = Date.now();
         try {
-            await throttle();
-            if (stoppedReason)
+            if (!await throttle())
+                return;
+            if (stoppedReason || stopIfRequested())
                 return; // an earlier job hit an unrecoverable stop — don't start more work
             const r = await runImportJob(args.client, job.id, s, args.userTz, args.encKey);
             extracted += r.memories;
@@ -1071,7 +1083,7 @@ async function runJobs(args) {
     let next = 0;
     const worker = async () => {
         for (;;) {
-            if (stoppedReason)
+            if (stoppedReason || stopIfRequested())
                 return;
             const myIdx = next++;
             if (myIdx >= total)

package/dist/setup-page/client-extraction.js

@@ -610,11 +610,23 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
         renderEnding();
         try {
           await postJson("/skip", {});
-        } catch (_) {
-          /* The bridge may close while ending; the local page can still show the paused state. */
+          await sleep(250);
+          renderSkipped();
+        } catch (error) {
+          // A paused screen is a promise: do not show it until the bridge confirms that no more
+          // conversations will be scheduled. Keep the active view visible when pausing fails.
+          extractionEnded = false;
+          var message = error && error.message ? error.message : "Could not pause extraction. It is still running.";
+          try {
+            renderProgress(await getJson("/progress"));
+            var notice = document.getElementById("exText");
+            if (notice) notice.insertAdjacentHTML("afterbegin", '<div class="error">' + esc(message) + '</div>');
+          } catch (_) {
+            setHead("Could not pause extraction", "Still extracting");
+            app.className = "notice";
+            app.innerHTML = '<h2>Extraction may still be running.</h2><p>' + esc(message) + '</p><p>Keep this page open and try ending it again in a moment.</p>';
+          }
         }
-        await sleep(650);
-        renderSkipped();
       }
       async function skip() {
         if (decisionMade) return;

package/dist/setup.js

@@ -1088,6 +1088,7 @@ export function startCallbackServer(opts = {}) {
         let migrateStarted = false;
         let tokenRefreshHandler = null;
         let logoutHandler = null;
+        let migrationPauseHandler = null;
         let timer;
         let closed = false;
         let server;
@@ -1463,6 +1464,23 @@ export function startCallbackServer(opts = {}) {
                     }
                     if (!checkNonce(asString(body.nonce)))
                         return void text(res, 403, "bad nonce");
+                    if (migrateStarted) {
+                        if (!migrationPauseHandler) {
+                            json(res, 409, { error: "MIGRATION_PAUSE_UNAVAILABLE", message: "Extraction is still starting. Try again in a moment." });
+                            return;
+                        }
+                        try {
+                            // Do not claim the work is paused until the import loop has stopped scheduling jobs.
+                            await migrationPauseHandler();
+                        }
+                        catch (error) {
+                            json(res, 500, {
+                                error: "MIGRATION_PAUSE_FAILED",
+                                message: error instanceof Error ? error.message : "Could not pause extraction.",
+                            });
+                            return;
+                        }
+                    }
                     json(res, 200, { ok: true });
                     decision.resolve("skip");
                     close();
@@ -1496,6 +1514,9 @@ export function startCallbackServer(opts = {}) {
                 setLogoutHandler: (handler) => {
                     logoutHandler = handler;
                 },
+                setMigrationPauseHandler: (handler) => {
+                    migrationPauseHandler = handler;
+                },
                 setAuthUrl: (url, nextSwitchAccountUrl) => {
                     authUrl = url;
                     switchAccountUrl = nextSwitchAccountUrl || url;
@@ -2199,6 +2220,15 @@ async function cmdLogin(flags) {
         await refreshLocalStatsForToken(nextToken);
     });
     await refreshLocalStatsForToken(token);
+    // A pause is deliberately transient. Completed conversations remain recorded in the normal
+    // import ledger; unfinished conversations are rediscovered and offered again by the next init.
+    let pauseRequested = false;
+    let pauseCompletion = null;
+    srv.setMigrationPauseHandler(async () => {
+        pauseRequested = true;
+        if (pauseCompletion)
+            await pauseCompletion;
+    });
     const choice = await srv.decision;
     if (choice === "migrate") {
         const { res } = await srv.migrateRequest;
@@ -2214,6 +2244,14 @@ async function cmdLogin(flags) {
         let progressDone = 0;
         let progressFailed = 0;
         let progressExtracted = 0;
+        let resolvePauseCompletion = null;
+        pauseCompletion = new Promise((resolve) => {
+            resolvePauseCompletion = resolve;
+        });
+        const completePause = () => {
+            resolvePauseCompletion?.();
+            resolvePauseCompletion = null;
+        };
         if (!disc) {
             srv.setProgress({
                 status: "starting",
@@ -2334,7 +2372,12 @@ async function cmdLogin(flags) {
                 let h;
                 try {
                     const controller = new AbortController();
-                    h = await withTimeout(startMigration({ pending: remaining, signal: controller.signal, onProgress: onBatchProgress }), 30_000, "IMPORT_START_TIMEOUT", () => controller.abort());
+                    h = await withTimeout(startMigration({
+                        pending: remaining,
+                        signal: controller.signal,
+                        onProgress: onBatchProgress,
+                        shouldStop: () => pauseRequested,
+                    }), 30_000, "IMPORT_START_TIMEOUT", () => controller.abort());
                 }
                 catch (batchError) {
                     if (batchIndex === 1)
@@ -2353,6 +2396,10 @@ async function cmdLogin(flags) {
                 }
                 console.log(`Migration metrics (batch ${batchIndex}): ${h.metricsFile}`);
                 const r = await h.done;
+                if (r.stoppedReason === "paused" || pauseRequested) {
+                    stoppedReason = "paused";
+                    break;
+                }
                 if (r.stoppedReason) {
                     stoppedReason = r.stoppedReason;
                     break;
@@ -2364,6 +2411,25 @@ async function cmdLogin(flags) {
                 }
                 break;
             }
+            if (stoppedReason === "paused") {
+                srv.setProgress({
+                    status: "paused",
+                    sessionId: activeSessionId || undefined,
+                    jobCount: activeJobCount,
+                    total: activeJobCount,
+                    completed: progressDone,
+                    running: 0,
+                    queued: Math.max(0, activeJobCount - progressDone - progressFailed),
+                    failed: progressFailed,
+                    extracted: progressExtracted,
+                    latest: "Paused by user. Re-run setup to continue the remaining conversations.",
+                });
+                console.log(`Import paused: ${progressDone} imported, ${progressExtracted} memories, ${progressFailed} failed.`);
+                completePause();
+                // /skip sends the browser acknowledgement and closes the localhost bridge after this
+                // safe pause boundary. Do not close it here first or the page can claim success early.
+                return true;
+            }
             srv.setProgress({
                 status: stoppedReason ? "failed" : "completed",
                 sessionId: activeSessionId || undefined,
@@ -2384,6 +2450,22 @@ async function cmdLogin(flags) {
             srv.close();
         }
         catch (e) {
+            if (pauseRequested) {
+                srv.setProgress({
+                    status: "paused",
+                    sessionId: activeSessionId || undefined,
+                    jobCount: activeJobCount,
+                    total: activeJobCount,
+                    completed: progressDone,
+                    running: 0,
+                    queued: Math.max(0, activeJobCount - progressDone - progressFailed),
+                    failed: progressFailed,
+                    extracted: progressExtracted,
+                    latest: "Paused by user. Re-run setup to continue the remaining conversations.",
+                });
+                completePause();
+                return true;
+            }
             srv.setProgress({
                 status: "failed",
                 sessionId: activeSessionId || undefined,

package/dist/v1-contract.js

@@ -109,6 +109,7 @@ export function listToolSpecs(opts = {}) {
     const map = opts.map?.trim();
     const updateNotice = opts.updateNotice?.trim();
     const paidRecallNote = "Requires Echo Pro or Power; saving conversations and memory extraction remain included.";
+    const searchBillingReplyInstruction = "If search returns an ACTION REQUIRED subscription message, tell the user to start their trial or subscription and include the exact URL from that result verbatim. Do not respond only with \"connect\" or \"upgrade\".";
     const updateSection = updateNotice ? `\n\nUPDATE NOTICE: ${updateNotice}` : "";
     const mapSection = map
         ? `\n\nThis user's EchoMem currently covers these topics (a relevance guide — recall when the task relates to one of them):\n${map}\n`
@@ -116,7 +117,7 @@ export function listToolSpecs(opts = {}) {
     return [
         {
             name: canonicalToolNames.search,
-            description: withMcpVersion(`Recall the user's prior decisions, preferences, and project context from EchoMem — their long-term memory across ALL their AI tools, not just this session. Use it instead of re-deriving or re-asking what the user already settled. ${paidRecallNote}${mapSection}\nReturns the ranked memories; set includeAnswer=true only if you need the legacy synthesized answer. Current time: ${currentTime}.${updateSection}`),
+            description: withMcpVersion(`Recall the user's prior decisions, preferences, and project context from EchoMem — their long-term memory across ALL their AI tools, not just this session. Use it instead of re-deriving or re-asking what the user already settled. ${paidRecallNote} ${searchBillingReplyInstruction}${mapSection}\nReturns the ranked memories; set includeAnswer=true only if you need the legacy synthesized answer. Current time: ${currentTime}.${updateSection}`),
             inputSchema: {
                 type: "object",
                 properties: {
@@ -139,7 +140,7 @@ export function listToolSpecs(opts = {}) {
         },
         {
             name: "search_memories_by_description_semantic",
-            description: `Legacy alias for search_memories. ${paidRecallNote}`,
+            description: `Legacy alias for search_memories. ${paidRecallNote} ${searchBillingReplyInstruction}`,
             inputSchema: {
                 type: "object",
                 properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@echomem/mcp",
-  "version": "1.4.16",
+  "version": "1.4.18",
   "description": "EchoMem MCP bridge: cloud-first memory tools, local context HUD, and the Agent Doctor workspace forensics report (cost ledger + 3D repo city)",
   "main": "dist/index.js",
   "type": "module",