@echomem/mcp 1.4.15 → 1.4.17

package/dist/billing-alert.js

@@ -0,0 +1,39 @@
+import fs from "node:fs";
+import path from "node:path";
+import { echoConfigDir } from "./keystore.js";
+const ALERT_FILE = "billing-alert.json";
+const DEFAULT_MAX_AGE_MS = 31 * 24 * 60 * 60 * 1000;
+function alertPath() {
+    return path.join(echoConfigDir(), ALERT_FILE);
+}
+export function writeBillingAlert(alert) {
+    try {
+        fs.mkdirSync(echoConfigDir(), { recursive: true, mode: 0o700 });
+        fs.writeFileSync(alertPath(), JSON.stringify({ ...alert, updatedAt: new Date().toISOString() }, null, 2), { mode: 0o600 });
+    }
+    catch {
+        /* best-effort: billing UI should never break search */
+    }
+}
+export function readBillingAlert(maxAgeMs = DEFAULT_MAX_AGE_MS) {
+    try {
+        const alert = JSON.parse(fs.readFileSync(alertPath(), "utf8"));
+        const updatedAt = Date.parse(alert.updatedAt || "");
+        if (!updatedAt || Date.now() - updatedAt > maxAgeMs)
+            return null;
+        if (!alert.message || !alert.pricingUrl)
+            return null;
+        return alert;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearBillingAlert() {
+    try {
+        fs.unlinkSync(alertPath());
+    }
+    catch {
+        /* absent is fine */
+    }
+}

package/dist/hud/diagnostics.js

@@ -30,21 +30,17 @@ function normalizePlan(value) {
 /** Parse the account bootstrap contract without importing app-only code into the npm package. */
 export function accountDiagnosticsFromBootstrap(payload) {
     const root = record(payload) ?? {};
-    const entitlements = record(root.entitlements) ?? {};
     const usage = record(root.usage) ?? {};
-    const activation = record(root.activation) ?? {};
-    const limit = number(entitlements.deepSearchPerMonth);
-    const searchesThisMonth = number(activation.memorySearchMonthToDateCount);
-    const searchesRemaining = limit === undefined || searchesThisMonth === undefined
-        ? undefined
-        : limit < 0
-            ? null
-            : Math.max(0, limit - searchesThisMonth);
+    const quota = record(root.memorySearchQuota) ?? {};
+    const weeklySearchLimit = number(quota.limit);
+    const searchesThisWeek = number(quota.used);
+    const searchesRemaining = quota.remaining === null ? null : number(quota.remaining);
     return {
         plan: normalizePlan(root.plan),
-        deepSearchPerMonth: limit,
-        searchesThisMonth,
+        weeklySearchLimit,
+        searchesThisWeek,
         searchesRemaining,
+        resetAt: text(quota.resetAt),
         memoryCount: number(usage.memories),
         sourceCount: number(usage.sources),
     };

package/dist/hud/server.js

@@ -10,7 +10,9 @@ import { loadHudDiagnostics } from "./diagnostics.js";
 import { homePath, newestFile, walkFiles } from "./fs.js";
 import { KeyStore } from "../keystore.js";
 import { assembleCodex, assembleClaude } from "../migrate.js";
+import { readBillingAlert } from "../billing-alert.js";
 const API_BASE = (process.env.ECHO_API_BASE_URL || "https://echo-mem-chrome.vercel.app").replace(/\/$/, "");
+const PRICING_URL = (process.env.ECHO_PRICING_URL || "https://echoknows.com/pricing").replace(/\/$/, "");
 export async function createHudServer(opts = {}) {
     const mode = opts.mode || "auto";
     const port = opts.port ?? 17377;
@@ -43,6 +45,32 @@ export async function createHudServer(opts = {}) {
             res.end(JSON.stringify(latest, null, 2));
             return;
         }
+        if (url.pathname === "/billing-status") {
+            handleBillingStatus(res).catch((error) => {
+                if (res.writableEnded)
+                    return;
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end(JSON.stringify({ ok: false, state: "unknown", reason: error instanceof Error ? error.message : "billing status failed" }));
+            });
+            return;
+        }
+        if (url.pathname === "/open-external") {
+            const target = url.searchParams.get("url") || "";
+            let ok = false;
+            try {
+                const parsed = new URL(target);
+                if ((parsed.protocol === "https:" || parsed.protocol === "http:") && typeof opts.onOpenExternal === "function") {
+                    opts.onOpenExternal(parsed.toString());
+                    ok = true;
+                }
+            }
+            catch {
+                ok = false;
+            }
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(JSON.stringify({ ok, reason: ok ? undefined : opts.onOpenExternal ? "invalid_url" : "no_desktop" }));
+            return;
+        }
         if (url.pathname === "/diagnostics") {
             loadHudDiagnostics().then((diagnostics) => {
                 if (res.writableEnded)
@@ -264,6 +292,69 @@ export async function createHudServer(opts = {}) {
         }),
     };
 }
+async function handleBillingStatus(res) {
+    const respond = (obj) => {
+        if (res.writableEnded)
+            return;
+        res.writeHead(200, { "content-type": "application/json" });
+        res.end(JSON.stringify(obj));
+    };
+    const pricingUrl = appendSource(PRICING_URL, "hud");
+    const alert = readBillingAlert();
+    const token = new KeyStore().getToken();
+    if (!token) {
+        return respond({ ok: false, state: "not_connected", pricingUrl });
+    }
+    let plan = "unknown";
+    let paid = false;
+    try {
+        const response = await fetch(`${API_BASE}/api/extension/account/bootstrap`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        const data = (await response.json().catch(() => ({})));
+        if (response.ok) {
+            plan = typeof data.plan === "string" ? data.plan.toLowerCase() : "free";
+            paid = ["pro", "power", "team", "enterprise"].includes(plan);
+        }
+    }
+    catch {
+        /* Local alert still gives the HUD something useful. */
+    }
+    if (alert && (alert.kind === "quota_exceeded" || !paid)) {
+        return respond({
+            ok: true,
+            state: alert.kind,
+            plan: alert.plan || plan,
+            message: alert.kind === "quota_exceeded" ? "Recall limit reached." : "Recall needs a plan.",
+            detail: alert.message,
+            code: alert.code,
+            pricingUrl: appendSource(alert.pricingUrl || pricingUrl, "hud"),
+            updatedAt: alert.updatedAt,
+        });
+    }
+    if (!paid && plan === "free") {
+        return respond({
+            ok: true,
+            state: "plan_required",
+            plan,
+            message: "Recall needs a plan.",
+            detail: "Search and recall require Echo Pro or Power. Saving conversations keeps working.",
+            pricingUrl,
+        });
+    }
+    respond({ ok: true, state: "ok", plan, paid, pricingUrl });
+}
+function appendSource(url, source) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.searchParams.has("source"))
+            parsed.searchParams.set("source", source);
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
 async function handleCheckpointStatus(latest, res) {
     const respond = (obj) => {
         if (res.writableEnded)

package/dist/hud/web.js

@@ -16,6 +16,10 @@ export const HUD_HTML = String.raw `<!doctype html>
         --brick: #c7372f;
         --green: #43d17a;
         --amber: #e9b949;
+        --billing-free-bg: #fff8d9;
+        --billing-free-border: rgba(190, 128, 19, 0.36);
+        --billing-free: #c08412;
+        --billing-free-dark: #87560d;
         --line: rgba(26, 58, 143, 0.22);
         --track: rgba(26, 58, 143, 0.1);
         --shadow: drop-shadow(0 2px 7px rgba(26, 58, 143, 0.12));
@@ -530,6 +534,75 @@ export const HUD_HTML = String.raw `<!doctype html>
         background: rgba(199, 55, 47, 0.07);
         color: #7a241e;
       }
+      .billing-banner {
+        display: none;
+        margin: 0 0 12px;
+        border: 1.4px solid var(--billing-free-border);
+        border-radius: 12px;
+        background: linear-gradient(180deg, var(--billing-free-bg), #fff);
+        padding: 10px;
+        color: var(--muted);
+        box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.82);
+      }
+      .billing-banner.limit {
+        border-color: rgba(255, 95, 87, 0.45);
+        background: linear-gradient(180deg, #fff3f2, #fff);
+      }
+      .billing-top {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+      }
+      .billing-dot {
+        width: 10px;
+        height: 10px;
+        flex: 0 0 auto;
+        border-radius: 999px;
+        background: var(--billing-free);
+        box-shadow: 0 0 0 4px rgba(190, 128, 19, 0.12);
+      }
+      .billing-banner.limit .billing-dot {
+        background: #ff5f57;
+        box-shadow: 0 0 0 4px rgba(255, 95, 87, 0.12);
+      }
+      .billing-title {
+        min-width: 0;
+        flex: 1;
+        color: var(--billing-free-dark);
+        font-size: 13px;
+        font-weight: 900;
+        line-height: 1.15;
+      }
+      .billing-banner.limit .billing-title { color: #7a241e; }
+      .billing-copy {
+        display: block;
+        margin: 8px 0 0 18px;
+        font-size: 11.5px;
+        line-height: 1.35;
+        font-weight: 650;
+      }
+      .billing-link {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        min-height: 28px;
+        border: 1px solid var(--billing-free-dark);
+        border-radius: 999px;
+        background: var(--billing-free);
+        color: #fff;
+        padding: 0 13px;
+        font-family: inherit;
+        font-size: 11px;
+        font-weight: 900;
+        cursor: pointer;
+        box-shadow: 0 12px 20px -16px rgba(135, 86, 13, 0.95);
+      }
+      .billing-banner.limit .billing-link {
+        border-color: #7a241e;
+        background: #7a241e;
+        box-shadow: 0 12px 20px -16px rgba(122, 36, 30, 0.95);
+      }
+      .billing-link:hover { filter: brightness(0.96); }
       button.renew-btn {
         display: none;
         width: 100%;
@@ -697,6 +770,14 @@ export const HUD_HTML = String.raw `<!doctype html>
             <button class="pin-chip" id="pinchip" type="button" title="Return to auto-follow">pinned x</button>
             <button class="jump-chip" id="jumpchip" type="button" title="Open this conversation">&#8599;</button>
           </div>
+          <div class="billing-banner" id="billingbanner">
+            <div class="billing-top">
+              <span class="billing-dot"></span>
+              <strong class="billing-title" id="billingtitle"></strong>
+              <button class="billing-link" id="billinglink" type="button">Open pricing</button>
+            </div>
+            <span class="billing-copy" id="billingcopy"></span>
+          </div>
           <div class="state-row">
             <span class="state-dot" id="stateDot"></span>
             <span class="state-word" id="stateWord">--%</span>
@@ -745,6 +826,10 @@ export const HUD_HTML = String.raw `<!doctype html>
       const whyBtn = document.getElementById("whybtn");
       const evidence = document.getElementById("evidence");
       const nudge = document.getElementById("nudge");
+      const billingBanner = document.getElementById("billingbanner");
+      const billingTitle = document.getElementById("billingtitle");
+      const billingCopy = document.getElementById("billingcopy");
+      const billingLink = document.getElementById("billinglink");
       const renewBtn = document.getElementById("renewbtn");
       const renewResult = document.getElementById("renewresult");
       const renewMsg = document.getElementById("renewmsg");
@@ -773,6 +858,7 @@ export const HUD_HTML = String.raw `<!doctype html>
       let renewStartMs = 0;
       let renewEta = null;
       let renewEstimateSeq = 0;
+      let billingStatus = null;
       let diagnosticsLoaded = false;
       let diagnosticsInFlight = false;
       const CHECKPOINT_CACHE_KEY = "echomemHudCheckpointCacheV2";
@@ -807,12 +893,13 @@ export const HUD_HTML = String.raw `<!doctype html>
         const lines = [];
         if (account.state === "connected") {
           lines.push(diagnosticsLine("account", planLabel(account.plan) + " · authenticated"));
-          if (typeof account.searchesThisMonth === "number" && typeof account.deepSearchPerMonth === "number") {
-            const limit = account.deepSearchPerMonth < 0 ? "Unlimited" : String(account.deepSearchPerMonth);
+          if (typeof account.searchesThisWeek === "number" && typeof account.weeklySearchLimit === "number") {
+            const limit = account.weeklySearchLimit < 0 ? "Unlimited" : String(account.weeklySearchLimit);
             const remaining = account.searchesRemaining === null ? "" : (typeof account.searchesRemaining === "number" ? " · " + account.searchesRemaining + " left" : "");
-            lines.push(diagnosticsLine("searches", account.searchesThisMonth + " / " + limit + " UTC month" + remaining));
+            lines.push(diagnosticsLine("searches", account.searchesThisWeek + " / " + limit + " UTC week" + remaining));
+            if (account.resetAt) lines.push(diagnosticsLine("resets", account.resetAt));
           } else {
-            lines.push(diagnosticsLine("searches", "month-to-date not reported"));
+            lines.push(diagnosticsLine("searches", "weekly quota not reported"));
           }
         } else if (account.state === "not_logged_in") {
           lines.push(diagnosticsLine("account", "not logged in", true));
@@ -984,6 +1071,19 @@ export const HUD_HTML = String.raw `<!doctype html>
         e.stopPropagation();
         selectSession("auto");
       });
+      if (billingLink) billingLink.addEventListener("click", (e) => {
+        e.stopPropagation();
+        const url = billingStatus && billingStatus.pricingUrl;
+        if (!url) return;
+        fetch("/open-external?url=" + encodeURIComponent(url))
+          .then((res) => res.json())
+          .then((data) => {
+            if (!data || !data.ok) window.open(url, "_blank", "noopener");
+          })
+          .catch(() => {
+            try { window.open(url, "_blank", "noopener"); } catch {}
+          });
+      });
       function selectSession(id) {
         if (!id) return;
         fetch("/select?id=" + encodeURIComponent(id))
@@ -1479,6 +1579,19 @@ export const HUD_HTML = String.raw `<!doctype html>
         const events = new EventSource("/events");
         events.onmessage = (event) => render(JSON.parse(event.data));
         fetch("/state").then((r) => r.json()).then(render).catch(() => {});
+        refreshBillingStatus();
+        setInterval(refreshBillingStatus, 30000);
+      }
+
+      async function refreshBillingStatus() {
+        try {
+          const res = await fetch("/billing-status");
+          billingStatus = await res.json();
+        } catch {
+          billingStatus = null;
+        }
+        renderBillingStatus();
+        syncHeight();
       }
 
       function render(state) {
@@ -1536,6 +1649,7 @@ export const HUD_HTML = String.raw `<!doctype html>
           jumpChip.style.display = activeId ? "inline-block" : "none";
         }
         renderWhy(score, oldPct, repeatCount, sat, health, color);
+        renderBillingStatus();
         pathEl.textContent = "";
         currentSrc = score.sourcePath || null;
         if (revealEl) revealEl.style.display = !DEMO_CLEAN && currentSrc ? "inline-block" : "none";
@@ -1596,6 +1710,7 @@ export const HUD_HTML = String.raw `<!doctype html>
         whyOpen = false;
         hud.classList.remove("show-why");
         nudge.style.display = "none";
+        renderBillingStatus();
         if (renewBtn) renewBtn.style.display = "none";
         clearRenewResult();
         pathEl.textContent = "";
@@ -1617,6 +1732,27 @@ export const HUD_HTML = String.raw `<!doctype html>
         if (mrepoLine) mrepoLine.style.display = repo ? "flex" : "none";
       }
 
+      function renderBillingStatus() {
+        if (!billingBanner) return;
+        const state = billingStatus && billingStatus.state;
+        const blocked = state === "plan_required" || state === "quota_exceeded" || state === "billing_attention";
+        billingBanner.style.display = blocked ? "block" : "none";
+        billingBanner.classList.toggle("limit", state === "quota_exceeded");
+        if (!blocked) return;
+        const title = state === "quota_exceeded"
+          ? "Recall limit reached"
+          : state === "plan_required"
+            ? "Recall paused · Free plan"
+            : billingStatus.message || "Billing needs attention";
+        const detail = state === "quota_exceeded"
+          ? "You used all Pro searches this month. Upgrade or wait for reset."
+          : state === "plan_required"
+            ? "Search memory requires Pro or Power. Saving still works."
+            : billingStatus.detail || "Open pricing to restore memory search.";
+        if (billingTitle) billingTitle.textContent = title;
+        if (billingCopy) billingCopy.textContent = detail;
+      }
+
       function renderWhy(score, oldPct, repeatCount, sat, health, color) {
         const rows = [];
         if (sat > 0) rows.push(["context", score.modelContextWindow ? sat + "% full · " + fmt(score.ctTokens) : fmt(score.ctTokens) + " tokens"]);

package/dist/index.js

@@ -13,8 +13,10 @@ import { createHash, randomUUID } from "node:crypto";
 import { fetchEncryptionConfig, decryptMemoryFields } from "./encryption.js";
 import { runCli } from "./setup.js";
 import { MCP_PACKAGE_VERSION, MCP_SERVER_INSTRUCTIONS } from "./package-metadata.js";
+import { clearBillingAlert, writeBillingAlert } from "./billing-alert.js";
 import { checkLatestUpdateStatus, formatUpdateNotice, formatUpdateStatusText, startBackgroundUpdateCheck, } from "./update-check.js";
 const ECHO_API_BASE_URL = process.env.ECHO_API_BASE_URL || "https://echo-mem-chrome.vercel.app";
+const ECHO_PRICING_URL = process.env.ECHO_PRICING_URL || "https://echoknows.com/pricing";
 /** Thrown when no API token is present yet — the model gets a "run login" nudge, not a hard error. */
 class NoTokenError extends Error {
 }
@@ -80,6 +82,59 @@ function describeError(error) {
     const fallback = stringifyErrorValue(error);
     return fallback || "Unknown error";
 }
+function appendPricingSource(url, source) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.searchParams.has("source")) {
+            parsed.searchParams.set("source", source);
+        }
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
+function formatUpgradeRequiredResult(error) {
+    if (!axios.isAxiosError(error))
+        return null;
+    const status = error.response?.status;
+    if (status !== 402 && status !== 403 && status !== 429)
+        return null;
+    const data = error.response?.data;
+    if (!isRecord(data))
+        return null;
+    const upgradeUrl = readString(data, "upgradeUrl")
+        ?? readString(data, "pricingUrl")
+        ?? readString(data, "url")
+        ?? ECHO_PRICING_URL;
+    const message = readString(data, "message")
+        ?? "Memory search and recall require an Echo Pro or Power plan.";
+    const code = readString(data, "error") ?? readString(data, "code");
+    const plan = readString(data, "plan");
+    const pricingUrl = appendPricingSource(upgradeUrl, "mcp_search");
+    const normalizedCode = String(code || "").toUpperCase();
+    const kind = status === 429 || normalizedCode.includes("QUOTA") || normalizedCode.includes("LIMIT")
+        ? "quota_exceeded"
+        : status === 402 || normalizedCode.includes("REQUIRES_PLAN")
+            ? "plan_required"
+            : "billing_attention";
+    writeBillingAlert({
+        kind,
+        code,
+        message,
+        plan,
+        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}.` : "",
+    ].filter(Boolean).join("\n");
+}
 /** Map a thrown error to the telemetry error_kind taxonomy. */
 function classifyError(error) {
     if (error instanceof NoTokenError)
@@ -108,7 +163,7 @@ function readNumber(record, key) {
 function errorCodeFrom(value) {
     if (!isRecord(value))
         return undefined;
-    return readString(value, "code") || readString(value, "errorCode");
+    return readString(value, "error") || readString(value, "code") || readString(value, "errorCode");
 }
 function compactOneLine(value, maxLength) {
     if (!value)
@@ -1150,6 +1205,12 @@ class EchoMemMCPServer {
                 if (error instanceof McpError) {
                     throw error;
                 }
+                const upgradeRequired = formatUpgradeRequiredResult(error);
+                if (upgradeRequired) {
+                    return {
+                        content: [{ type: "text", text: upgradeRequired }],
+                    };
+                }
                 return {
                     content: [{ type: "text", text: `Error: ${describeError(error)}` }],
                     isError: true,
@@ -1206,6 +1267,7 @@ class EchoMemMCPServer {
             rec.http_status = trace.httpStatus;
             rec.error_code = trace.errorCode;
         });
+        clearBillingAlert();
         if (rec) {
             // "Which memories were used": topic keys + delivered context size, for the comparison dataset.
             const mems = Array.isArray(result?.memories) ? result.memories : [];

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

@@ -457,18 +457,24 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
       function recallGateUnlocked() {
         return recallGateSkipped || paidRecallPlan(billingStatus && billingStatus.plan);
       }
+      function recallTrialAvailable() {
+        return !billingStatus || billingStatus.trialAvailable !== false;
+      }
       function recallGateBlock() {
         var unlocked = recallGateUnlocked();
+        var trialAvailable = recallTrialAvailable();
         return '<div class="recallGateBlock">' +
           '<section class="recallGate' + (unlocked ? " is-hidden" : "") + '" id="recallGate">' +
-            '<p class="recallEyebrow">Memory saved. Recall is next.</p>' +
-            '<h3>Choose your 14-day trial plan for Codex and Claude recall.</h3>' +
-            '<p>Saving conversations and extracting memory stay included. Compare Pro and Power, then choose the plan that should unlock <code>search_memories</code>, project recall, and the prompt below.</p>' +
+            '<p class="recallEyebrow"><i></i>Premium recall</p>' +
+            '<h3 id="recallGateTitle">' + (trialAvailable ? "Unlock memory search for your agents." : "Ready to turn recall back on?") + '</h3>' +
+            '<p id="recallGateBody">' + (trialAvailable ? "Start a 14-day trial and let Codex, Claude, and MCP clients search what Echo saved. Saving conversations keeps working either way." : "Choose Pro or Power to let Codex, Claude, and MCP clients search what Echo saved. Saving conversations keeps working either way.") + '</p>' +
+            '<div class="recallTrial' + (trialAvailable ? "" : " is-hidden") + '" id="recallTrialBadge" aria-label="14 days free"><strong>14</strong><span>days free<br>then choose what fits</span></div>' +
+            '<p class="recallUsedNote' + (trialAvailable ? " is-hidden" : "") + '" id="recallUsedNote">Your trial was already used. You can still unlock recall by choosing Pro or Power.</p>' +
             '<div class="recallGateActions">' +
-              '<button type="button" class="primary" id="recallStartTrial">Compare plans</button>' +
-              '<button type="button" class="secondary" id="recallSkip">Skip for now</button>' +
+              '<button type="button" class="primary" id="recallStartTrial">' + (trialAvailable ? "Compare Pro and Power" : "See pricing") + '</button>' +
+              '<button type="button" class="textButton" id="recallSkip">Skip recall for now</button>' +
             '</div>' +
-            '<p class="recallFine">Card required for trial. Cancel anytime.</p>' +
+            '<p class="recallFine" id="recallFine">' + (trialAvailable ? "Card required for trial. Cancel anytime." : "Cancel anytime.") + '</p>' +
             '<p class="launchStatus" id="recallGateStatus"></p>' +
           '</section>' +
           '<div id="recallTryWrap" class="recallTryWrap' + (unlocked ? "" : " is-hidden") + '">' +
@@ -489,6 +495,21 @@ export const SETUP_PAGE_CLIENT_EXTRACTION = String.raw `      /* ---------- dash
         if (gate) gate.classList.toggle("is-hidden", unlocked);
         if (wrap) wrap.classList.toggle("is-hidden", !unlocked);
         if (skipNote) skipNote.classList.toggle("is-hidden", !recallGateSkipped);
+        var trialAvailable = recallTrialAvailable();
+        var badge = document.getElementById("recallTrialBadge");
+        if (badge) badge.classList.toggle("is-hidden", !trialAvailable);
+        var usedNote = document.getElementById("recallUsedNote");
+        if (usedNote) usedNote.classList.toggle("is-hidden", trialAvailable);
+        var title = document.getElementById("recallGateTitle");
+        if (title) title.textContent = trialAvailable ? "Unlock memory search for your agents." : "Ready to turn recall back on?";
+        var body = document.getElementById("recallGateBody");
+        if (body) body.textContent = trialAvailable
+          ? "Start a 14-day trial and let Codex, Claude, and MCP clients search what Echo saved. Saving conversations keeps working either way."
+          : "Choose Pro or Power to let Codex, Claude, and MCP clients search what Echo saved. Saving conversations keeps working either way.";
+        var cta = document.getElementById("recallStartTrial");
+        if (cta) cta.textContent = trialAvailable ? "Compare Pro and Power" : "See pricing";
+        var fine = document.getElementById("recallFine");
+        if (fine) fine.textContent = trialAvailable ? "Card required for trial. Cancel anytime." : "Cancel anytime.";
       }
       async function refreshBillingStatus() {
         try {

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

@@ -683,62 +683,118 @@ export const SETUP_PAGE_STYLES_EXTRACTION = String.raw `    /* ---- dashboard (p
     .exOverdue { margin: 0; max-width: 620px; border: 1px solid rgba(196, 148, 42, 0.45); background: rgba(233, 185, 73, 0.12); border-radius: 8px; padding: 12px 14px; font-size: 13px; line-height: 1.5; color: var(--echo-ink-text); }
     .exOverdue strong { display: block; margin-bottom: 4px; color: var(--echo-ink-primary); }
     .is-hidden { display: none !important; }
-    .recallGateBlock { width: min(760px, 100%); margin: 2px auto 0; }
+    .recallGateBlock { width: min(680px, 100%); margin: 2px auto 0; }
     .recallGate {
       width: 100%;
-      border: 2px solid var(--echo-ink-primary);
-      border-radius: 8px;
-      background: var(--echo-paper-white);
-      padding: clamp(18px, 3vw, 26px);
-      box-shadow: 0 18px 38px -28px rgba(26,58,143,0.45);
+      position: relative;
+      overflow: hidden;
+      border: 1px solid rgba(33,64,154,0.42);
+      border-radius: 12px;
+      background:
+        linear-gradient(180deg, rgba(239,244,255,0.98) 0%, rgba(255,255,255,0.99) 46%),
+        var(--echo-paper-white);
+      padding: clamp(24px, 4vw, 36px);
+      box-shadow: 0 28px 60px -42px rgba(33,64,154,0.48);
       text-align: left;
     }
+    .recallGate::before {
+      content: "";
+      position: absolute;
+      inset: 0 0 auto 0;
+      height: 8px;
+      background: linear-gradient(90deg, #18317d, #4b6bd4, var(--echo-ink-primary));
+    }
     .recallEyebrow {
-      margin: 0 0 10px;
+      display: inline-flex;
+      align-items: center;
+      gap: 8px;
+      margin: 0 0 14px;
+      border: 1px solid rgba(33,64,154,0.18);
+      border-radius: 999px;
+      background: #eef3ff;
+      padding: 7px 11px;
       font-family: var(--echo-font-mono);
       font-size: 11px;
-      font-weight: 800;
-      letter-spacing: 0.08em;
+      font-weight: 900;
+      letter-spacing: 0.06em;
       text-transform: uppercase;
-      color: var(--echo-ink-primary);
+      color: #18317d;
+    }
+    .recallEyebrow i {
+      width: 8px;
+      height: 8px;
+      border-radius: 999px;
+      background: var(--echo-ink-primary);
+      box-shadow: 0 0 0 4px rgba(33,64,154,0.1);
     }
     .recallGate h3 {
       margin: 0;
-      max-width: 680px;
+      max-width: 520px;
       font-family: var(--echo-font-brand);
-      font-size: clamp(30px, 3.8vw, 48px);
-      line-height: 0.98;
+      font-size: clamp(34px, 4.6vw, 48px);
+      line-height: 1.02;
       font-weight: 900;
-      color: var(--echo-ink-primary);
+      color: var(--echo-ink-text);
       letter-spacing: 0;
     }
     .recallGate p {
-      max-width: 620px;
+      max-width: 560px;
       margin: 14px 0 0;
-      font-size: 15px;
+      font-size: 16px;
       line-height: 1.55;
       color: var(--echo-ink-mute);
     }
-    .recallGate code,
-    .recallSkipNote code {
-      font-family: var(--echo-font-mono);
-      font-size: 0.92em;
-      background: var(--echo-paper-soft);
-      border: 1px solid var(--echo-line-soft);
-      border-radius: 5px;
-      padding: 1px 5px;
-      color: var(--echo-ink-primary);
+    .recallTrial {
+      margin-top: 18px;
+      display: inline-grid;
+      grid-template-columns: auto 1fr;
+      gap: 10px;
+      align-items: center;
+      border: 1px solid rgba(33,64,154,0.18);
+      border-radius: 10px;
+      background: #f3f6ff;
+      padding: 10px 12px;
+      color: #18317d;
+    }
+    .recallTrial strong {
+      font-size: 28px;
+      line-height: 1;
+      color: #18317d;
+    }
+    .recallTrial span {
+      font-size: 13px;
+      line-height: 1.25;
+      font-weight: 800;
+    }
+    .recallUsedNote {
+      margin-top: 18px;
+      border-left: 4px solid var(--echo-ink-primary);
+      background: #f3f6ff;
+      padding: 11px 13px;
+      color: #18317d;
+      font-size: 13px;
+      line-height: 1.45;
+      font-weight: 700;
     }
     .recallGateActions {
       display: flex;
       flex-wrap: wrap;
-      gap: 10px;
+      gap: 14px;
       align-items: center;
-      margin-top: 22px;
+      margin-top: 24px;
     }
     .recallGateActions button {
-      min-height: 48px;
-      padding: 0 18px;
+      min-height: 50px;
+    }
+    .recallGateActions .primary {
+      min-width: 0;
+      border-color: #18317d;
+      background: var(--echo-ink-primary);
+      color: #fff;
+      box-shadow: 0 18px 34px -26px rgba(33,64,154,0.85);
+    }
+    .recallGateActions .primary:hover {
+      background: #18317d;
     }
     .recallGate .recallFine {
       margin-top: 10px;
@@ -746,6 +802,19 @@ export const SETUP_PAGE_STYLES_EXTRACTION = String.raw `    /* ---- dashboard (p
       font-size: 11px;
       color: var(--echo-ink-faint);
     }
+    @media (max-width: 720px) {
+      .recallGateActions .primary { width: 100%; }
+    }
+    .recallGate code,
+    .recallSkipNote code {
+      font-family: var(--echo-font-mono);
+      font-size: 0.92em;
+      background: var(--echo-paper-soft);
+      border: 1px solid var(--echo-line-soft);
+      border-radius: 5px;
+      padding: 1px 5px;
+      color: var(--echo-ink-primary);
+    }
     .recallTryWrap { width: 100%; }
     .recallSkipNote {
       margin: 0 0 12px;

package/dist/setup.js

@@ -1257,20 +1257,24 @@ export function startCallbackServer(opts = {}) {
                     const token = new KeyStore().getToken();
                     const pricingUrl = `${PRICING_URL}?source=mcp_onboarding`;
                     if (!token) {
-                        json(res, 200, { plan: "free", paid: false, pricingUrl });
+                        json(res, 200, { plan: "free", paid: false, trialAvailable: true, trialUsed: false, pricingUrl });
                         return;
                     }
                     try {
                         const response = await authedAxios(token).get("/api/extension/account/bootstrap", { timeout: 6000 });
                         const plan = (asString(response.data?.plan) || "free").toLowerCase();
+                        const trialUsed = response.data?.billing?.trialUsed === true;
+                        const trialAvailable = response.data?.billing?.trialAvailable !== false;
                         json(res, 200, {
                             plan,
                             paid: ["pro", "power", "team", "enterprise"].includes(plan),
+                            trialAvailable,
+                            trialUsed,
                             pricingUrl,
                         });
                     }
                     catch {
-                        json(res, 200, { plan: "unknown", paid: false, pricingUrl });
+                        json(res, 200, { plan: "unknown", paid: false, trialAvailable: true, trialUsed: false, pricingUrl });
                     }
                     return;
                 }

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.15",
+  "version": "1.4.17",
   "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",