@noelclaw/mcp 2.3.0 → 2.4.0

package/dist/tools/os.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OS_TOOLS = void 0;
+exports.handleOsTool = handleOsTool;
+const zod_1 = require("zod");
+const convex_js_1 = require("../convex.js");
+const market_js_1 = require("./market.js");
+const memory_js_1 = require("./memory.js");
+exports.OS_TOOLS = [
+    {
+        name: "noel_status",
+        description: "Full system dashboard for the Noelclaw AI OS — memory usage, swarm health, active automations, " +
+            "recent vault research, and execution scores. Like `htop` but for your AI operating system. " +
+            "Run this to get a complete picture of what's running and what your OS currently knows.",
+        inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+        name: "noel_boot",
+        description: "Boot sequence for the Noelclaw AI OS — starts the swarm, loads live market prices, checks active automations, " +
+            "and returns a unified briefing. One command to wake up the entire operating system. " +
+            "Run this first to prime the system before any trading or research session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                focus: {
+                    type: "string",
+                    description: "Optional: token or topic to focus today's session on (e.g. 'ETH', 'Base ecosystem')",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "noel_shutdown",
+        description: "Clean shutdown of the Noelclaw AI OS — stops the swarm, saves a session summary to vault, and returns a final briefing. " +
+            "Run at the end of a trading or research session to persist all findings before signing off.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                note: {
+                    type: "string",
+                    description: "Optional: a note to save with the session summary (e.g. 'Closed ETH position, watching BTC')",
+                },
+            },
+            required: [],
+        },
+    },
+];
+const BootSchema = zod_1.z.object({ focus: zod_1.z.string().optional() });
+const ShutdownSchema = zod_1.z.object({ note: zod_1.z.string().max(500).optional() });
+async function handleOsTool(name, args) {
+    switch (name) {
+        case "noel_status": {
+            const [memRes, swarmRes, autoRes, vaultRes, scoresRes] = await Promise.allSettled([
+                (0, convex_js_1.callConvex)("/memory/profile", "GET"),
+                (0, convex_js_1.callConvex)("/swarm/status", "GET", undefined, "get_swarm_status"),
+                (0, convex_js_1.callConvex)("/automations/list", "GET", undefined, "list_automations"),
+                (0, convex_js_1.callConvex)("/vault/list?type=research&limit=5", "GET", undefined, "noel_status"),
+                (0, convex_js_1.callConvex)("/swarm/scores", "GET", undefined, "get_execution_scores"),
+            ]);
+            const mem = memRes.status === "fulfilled" ? memRes.value : null;
+            const swarm = swarmRes.status === "fulfilled" ? swarmRes.value : null;
+            const autos = autoRes.status === "fulfilled" ? autoRes.value : null;
+            const vault = vaultRes.status === "fulfilled" ? vaultRes.value : null;
+            const scores = scoresRes.status === "fulfilled" ? scoresRes.value : null;
+            const automations = autos?.automations ?? [];
+            const activeAutos = automations.filter((a) => a.status === "active");
+            const vaultEntries = vault?.entries ?? [];
+            const allScores = (scores?.scores ?? []).sort((a, b) => b.lastScore - a.lastScore);
+            const topScore = allScores[0];
+            const swarmActive = swarm?.active ?? false;
+            const memTotal = mem?.total ?? 0;
+            const memStatus = mem?.status ?? "unknown";
+            const lines = [
+                `**Noelclaw AI OS — System Status**`,
+                `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+                ``,
+                `🧠 **Memory**       ${memStatus === "ok" ? "✅" : "⚠️"} ${memTotal} memories · Space: ${mem?.space ?? "—"}`,
+                `🤖 **Swarm**        ${swarmActive ? "✅ Active" : "⏹️ Offline"} · ${swarm?.memory?.length ?? 0} shared memory entries`,
+                `⚡ **Automations**  ${activeAutos.length} active of ${automations.length} total`,
+                allScores.length
+                    ? `📊 **Top Skill**    ${topScore.skillName} — ${((topScore.lastScore ?? 0) * 100).toFixed(0)}% · ${topScore.successCount}W/${topScore.failCount}L`
+                    : `📊 **Skills**       No execution history yet`,
+                ``,
+            ];
+            if (activeAutos.length > 0) {
+                lines.push(`**Active Automations:**`);
+                for (const a of activeAutos.slice(0, 5)) {
+                    const next = a.nextRunAt ? ` · next ${new Date(a.nextRunAt).toUTCString()}` : "";
+                    lines.push(`  • ${a.name} — ${a.triggerType}${next}`);
+                }
+                lines.push("");
+            }
+            if (vaultEntries.length > 0) {
+                lines.push(`**Recent Research:**`);
+                for (const e of vaultEntries) {
+                    lines.push(`  • [${e.agentId ?? "vault"}] ${e.title}`);
+                }
+                lines.push("");
+            }
+            lines.push(swarmActive
+                ? `💡 Run \`swarm_pulse\` for a live snapshot from all agents.`
+                : `💡 Run \`noel_boot\` to wake up the full system.`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        case "noel_boot": {
+            const parsed = BootSchema.safeParse(args ?? {});
+            if (!parsed.success)
+                return { content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }], isError: true };
+            const { focus } = parsed.data;
+            const [swarmRes, marketRes, autoRes, memRes, focusRes] = await Promise.allSettled([
+                (0, convex_js_1.callConvex)("/swarm/start", "POST", {}, "start_swarm"),
+                (0, market_js_1.fetchMarketSnapshot)(),
+                (0, convex_js_1.callConvex)("/automations/list", "GET", undefined, "list_automations"),
+                (0, convex_js_1.callConvex)("/memory/profile", "GET"),
+                focus ? (0, memory_js_1.searchSupermemory)(focus, 4) : Promise.resolve([]),
+            ]);
+            const swarm = swarmRes.status === "fulfilled" ? swarmRes.value : null;
+            const market = marketRes.status === "fulfilled" ? marketRes.value : null;
+            const autos = autoRes.status === "fulfilled" ? autoRes.value : null;
+            const mem = memRes.status === "fulfilled" ? memRes.value : null;
+            const focusMem = focusRes.status === "fulfilled" ? focusRes.value : [];
+            const automations = autos?.automations ?? [];
+            const activeAutos = automations.filter((a) => a.status === "active");
+            const memTotal = mem?.total ?? 0;
+            const p = (n) => `$${n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+            const lines = [
+                `🚀 **Noelclaw AI OS — Boot Complete**`,
+                `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+                `${new Date().toUTCString()}`,
+                ``,
+                `**Subsystems:**`,
+                `  🤖 Swarm        ${swarm?.success ? `✅ Online · session ${swarm.sessionId ?? "active"}` : "⚠️ Could not start"}`,
+                `  🧠 Memory       ✅ ${memTotal} memories ready`,
+                `  ⚡ Automations  ${activeAutos.length} active of ${automations.length}`,
+                ``,
+            ];
+            if (market) {
+                lines.push(`**Market Snapshot:**`);
+                lines.push(`  BTC ${p(market.btc)}  ·  ETH ${p(market.eth)}  ·  SOL ${p(market.sol)}`);
+                lines.push("");
+            }
+            if (activeAutos.length > 0) {
+                lines.push(`**Active Automations:**`);
+                for (const a of activeAutos.slice(0, 5)) {
+                    const next = a.nextRunAt ? ` · runs ${new Date(a.nextRunAt).toUTCString()}` : "";
+                    lines.push(`  • ${a.name}${next}`);
+                }
+                lines.push("");
+            }
+            if (focus && focusMem.length > 0) {
+                lines.push(`**Memory context for "${focus}" (${focusMem.length} items):**`);
+                for (const r of focusMem) {
+                    const title = r.metadata?.title ?? r.content.slice(0, 70).replace(/\n/g, " ");
+                    lines.push(`  • ${title}`);
+                }
+                lines.push("");
+            }
+            lines.push(`**Quick actions:**`);
+            lines.push(`  • \`swarm_pulse\` — live readings from all agents`);
+            if (focus) {
+                lines.push(`  • \`swarm_research topic: "${focus}"\` — deep research session`);
+                lines.push(`  • \`memory_insight topic: "${focus}"\` — full intelligence report`);
+            }
+            else {
+                lines.push(`  • \`swarm_research topic: "BTC"\` — start morning research`);
+                lines.push(`  • \`noel_status\` — full system dashboard`);
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        case "noel_shutdown": {
+            const parsed = ShutdownSchema.safeParse(args ?? {});
+            if (!parsed.success)
+                return { content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }], isError: true };
+            const { note } = parsed.data;
+            const [swarmRes, vaultRes] = await Promise.allSettled([
+                (0, convex_js_1.callConvex)("/swarm/stop", "POST", {}, "stop_swarm"),
+                (0, convex_js_1.callConvex)("/vault/list?type=research&limit=5", "GET", undefined, "noel_shutdown"),
+            ]);
+            const swarm = swarmRes.status === "fulfilled" ? swarmRes.value : null;
+            const vault = vaultRes.status === "fulfilled" ? vaultRes.value : null;
+            const vaultEntries = vault?.entries ?? [];
+            const now = new Date();
+            const sessionKey = `session/shutdown-${now.toISOString().slice(0, 10)}-${now.getHours()}h`;
+            const summaryContent = [
+                `# Session Shutdown — ${now.toUTCString()}`,
+                note ? `\nNote: ${note}` : "",
+                `\n## Recent Research`,
+                ...vaultEntries.map((e) => `• [${e.agentId ?? "vault"}] ${e.title}`),
+            ].filter(Boolean).join("\n");
+            await (0, convex_js_1.callConvex)("/vault/save", "POST", {
+                type: "memory",
+                title: `Session: ${now.toLocaleDateString("en-US")}${note ? ` — ${note.slice(0, 50)}` : ""}`,
+                content: summaryContent,
+                key: sessionKey,
+                agentId: "os",
+                tags: ["session", "shutdown"],
+                commitMsg: "noel_shutdown session save",
+            }, "noel_shutdown").catch(() => { });
+            const lines = [
+                `⏹️ **Noelclaw AI OS — Shutdown**`,
+                `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+                `${now.toUTCString()}`,
+                ``,
+                `🤖 Swarm      ${swarm?.success ? "✅ Stopped" : "⚠️ Already offline"}`,
+                `💾 Session    ✅ Saved to vault: \`${sessionKey}\``,
+                note ? `📝 Note       ${note}` : "",
+                ``,
+            ];
+            if (vaultEntries.length > 0) {
+                lines.push(`**Session research (${vaultEntries.length} entries):**`);
+                for (const e of vaultEntries) {
+                    lines.push(`  • [${e.agentId ?? "vault"}] ${e.title}`);
+                }
+                lines.push("");
+            }
+            lines.push(`Run \`noel_boot\` to start a new session.`);
+            return { content: [{ type: "text", text: lines.filter(l => l !== undefined && l !== "").join("\n") }] };
+        }
+        default:
+            return null;
+    }
+}

package/dist/tools/scanner.js

@@ -85,13 +85,116 @@ function scoreDipReversal(c, minLiquidity = DEFAULT_MIN_LIQ) {
         buyPressure5m: bp,
     };
 }
-// ── Fetch helper ──────────────────────────────────────────────────────────────
+// ── Fetch helpers ─────────────────────────────────────────────────────────────
 async function fetchJson(url) {
     const res = await fetch(url, { signal: AbortSignal.timeout(15000) });
     if (!res.ok)
         throw new Error(`HTTP ${res.status} from ${new URL(url).hostname}`);
     return res.json();
 }
+async function fetchBasePools(minLiquidity, limit) {
+    const [trendingRes, newPoolsRes] = await Promise.allSettled([
+        fetchJson("https://api.geckoterminal.com/api/v2/networks/base/trending_pools?page=1"),
+        fetchJson("https://api.geckoterminal.com/api/v2/networks/base/new_pools?page=1"),
+    ]);
+    const rawPools = [
+        ...(trendingRes.status === "fulfilled" ? trendingRes.value.data ?? [] : []),
+        ...(newPoolsRes.status === "fulfilled" ? newPoolsRes.value.data ?? [] : []),
+    ];
+    if (!rawPools.length)
+        throw new Error("GeckoTerminal returned no pools. Try again in a moment.");
+    const seen = new Set();
+    const deduped = rawPools.filter(p => {
+        if (!p?.attributes || !p.id)
+            return false;
+        if (seen.has(p.id))
+            return false;
+        seen.add(p.id);
+        return true;
+    });
+    return deduped
+        .map((p) => {
+        const a = p.attributes ?? {};
+        const txns = a.transactions ?? {};
+        const pc = a.price_change_percentage ?? {};
+        const vol = a.volume_usd ?? {};
+        const liq = parseFloat(a.reserve_in_usd ?? "0");
+        const tokenRel = p.relationships?.base_token?.data?.id ?? "";
+        const mint = tokenRel.includes("_") ? tokenRel.split("_")[1] : tokenRel;
+        if (!mint?.startsWith("0x"))
+            return null;
+        return {
+            mint,
+            symbol: (a.name ?? "").split(" / ")[0] || mint.slice(0, 8),
+            priceUsd: parseFloat(a.base_token_price_usd ?? "0"),
+            priceChange5m: parseFloat(pc.m5 ?? "0"),
+            priceChange1h: parseFloat(pc.h1 ?? "0"),
+            priceChange6h: parseFloat(pc.h6 ?? "0"),
+            priceChange24h: parseFloat(pc.h24 ?? "0"),
+            volume1h: parseFloat(vol.h1 ?? "0"),
+            liquidity: liq,
+            buys5m: txns.m5?.buys ?? 0,
+            sells5m: txns.m5?.sells ?? 0,
+            buys1h: txns.h1?.buys ?? 0,
+            sells1h: txns.h1?.sells ?? 0,
+        };
+    })
+        .filter((c) => c !== null && c.liquidity >= minLiquidity)
+        .slice(0, limit);
+}
+function scoreMomentum(c, minLiquidity = DEFAULT_MIN_LIQ) {
+    const pc5m = c.priceChange5m;
+    const pc1h = c.priceChange1h;
+    const pc6h = c.priceChange6h;
+    const pc24h = c.priceChange24h;
+    const liq = c.liquidity;
+    const vol1h = c.volume1h;
+    const totalTxns5m = c.buys5m + c.sells5m;
+    const buyRatio5m = totalTxns5m > 0 ? c.buys5m / totalTxns5m : 0;
+    const totalTxns1h = c.buys1h + c.sells1h;
+    const buyRatio1h = totalTxns1h > 0 ? c.buys1h / totalTxns1h : 0;
+    const bp = buyRatio5m * 100;
+    // Hard gates — all must pass
+    const gateFailures = [];
+    if (pc1h < 3)
+        gateFailures.push(`1h momentum weak (${pc1h.toFixed(1)}% < 3%)`);
+    if (pc5m < 0.5)
+        gateFailures.push(`5m not accelerating (${pc5m.toFixed(1)}% < 0.5%)`);
+    if (totalTxns5m > 5 && buyRatio5m < 0.55)
+        gateFailures.push(`buy pressure low (${bp.toFixed(0)}% < 55%)`);
+    if (liq < minLiquidity)
+        gateFailures.push(`liquidity $${(liq / 1000).toFixed(0)}k < $${(minLiquidity / 1000).toFixed(0)}k min`);
+    if (pc24h > 150)
+        gateFailures.push(`already parabolic (24h ${pc24h.toFixed(0)}%)`);
+    if (gateFailures.length > 0) {
+        return { score: 0, passed: false, pattern: null, gateFailures, buyPressure5m: bp };
+    }
+    // 1. Momentum strength (0–25 pts)
+    const momentumPts = pc1h >= 20 ? 25 : pc1h >= 10 ? 20 : pc1h >= 6 ? 15 : pc1h >= 3 ? 8 : 3;
+    // 2. 5m acceleration (0–20 pts)
+    const accelPts = pc5m >= 5 ? 20 : pc5m >= 3 ? 16 : pc5m >= 2 ? 12 : pc5m >= 1 ? 7 : 3;
+    // 3. Buy pressure (0–15 pts)
+    const bpPts = bp >= 70 ? 15 : bp >= 65 ? 12 : bp >= 60 ? 9 : bp >= 55 ? 5 : 2;
+    // 4. Volume & activity (0–15 pts)
+    const actPts = vol1h >= 100000 && totalTxns1h >= 200 ? 15
+        : vol1h >= 50000 && totalTxns1h >= 100 ? 12
+            : vol1h >= 20000 && totalTxns1h >= 40 ? 8
+                : vol1h >= 5000 && totalTxns1h >= 10 ? 4 : 1;
+    // 5. Trend continuation (0–15 pts)
+    let trendPts = 0;
+    if (pc6h > 5 && pc24h > 5)
+        trendPts = 15;
+    else if (pc6h > 0 && pc24h > 0)
+        trendPts = 10;
+    else if (pc6h > 0)
+        trendPts = 5;
+    // 6. Sentiment acceleration (0–10 pts)
+    const sentAccel = buyRatio5m - buyRatio1h;
+    const sentPts = sentAccel >= 0.10 ? 10 : sentAccel >= 0.05 ? 7 : sentAccel >= 0 ? 3 : 0;
+    const score = Math.max(0, Math.min(100, momentumPts + accelPts + bpPts + actPts + trendPts + sentPts));
+    const pattern = pc1h >= 15 ? "BREAKOUT" : pc1h >= 8 ? "MOMENTUM" : pc1h >= 3 ? "PUSH" : "WEAK-PUSH";
+    return { score, passed: true, pattern, gateFailures: [], buyPressure5m: bp };
+}
 // ── Schemas ───────────────────────────────────────────────────────────────────
 const AddressSchema = zod_1.z.string().regex(/^0x[0-9a-fA-F]{40}$/, "must be a valid 0x address");
 const ScoreTokenSchema = zod_1.z.object({ address: AddressSchema, minLiquidity: zod_1.z.number().positive().optional() });
@@ -101,6 +204,11 @@ const ScanDipsSchema = zod_1.z.object({
     minLiquidity: zod_1.z.number().positive().optional(),
     limit: zod_1.z.number().int().min(1).max(100).optional(),
 }).default({});
+const ScanMomentumSchema = zod_1.z.object({
+    minScore: zod_1.z.number().min(0).max(100).optional(),
+    minLiquidity: zod_1.z.number().positive().optional(),
+    limit: zod_1.z.number().int().min(1).max(100).optional(),
+}).default({});
 // ── Tool definitions ──────────────────────────────────────────────────────────
 exports.SCANNER_TOOLS = [
     {
@@ -139,6 +247,22 @@ exports.SCANNER_TOOLS = [
             required: [],
         },
     },
+    {
+        name: "scan_momentum",
+        description: "Scan Base pools for momentum breakout setups — tokens with strong 1h+ upward momentum that are still accelerating. " +
+            "The inverse of scan_dips: finds BREAKOUT / MOMENTUM / PUSH patterns instead of dip-reversals. " +
+            "Gates: 1h > +3%, 5m still rising, buy pressure > 55%, not already parabolic (24h < 150%). " +
+            "Returns scored and ranked candidates. No API keys required.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                minScore: { type: "number", description: "Min score to include (default 50)" },
+                minLiquidity: { type: "number", description: "Min pool liquidity in USD (default 50000)" },
+                limit: { type: "number", description: "Max pools to scan (default 40, max 100)" },
+            },
+            required: [],
+        },
+    },
 ];
 // ── Handlers ──────────────────────────────────────────────────────────────────
 async function handleScannerTool(name, args) {
@@ -279,58 +403,13 @@ async function handleScannerTool(name, args) {
         if (!parsed.success)
             return { content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }], isError: true };
         const { minScore = DEFAULT_MIN_SCORE, minLiquidity = DEFAULT_MIN_LIQ, limit = 40 } = parsed.data;
-        // Fetch trending + new pools on Base from GeckoTerminal in parallel
-        const [trendingRes, newPoolsRes] = await Promise.allSettled([
-            fetchJson("https://api.geckoterminal.com/api/v2/networks/base/trending_pools?page=1"),
-            fetchJson("https://api.geckoterminal.com/api/v2/networks/base/new_pools?page=1"),
-        ]);
-        const rawPools = [
-            ...(trendingRes.status === "fulfilled" ? trendingRes.value.data ?? [] : []),
-            ...(newPoolsRes.status === "fulfilled" ? newPoolsRes.value.data ?? [] : []),
-        ];
-        if (!rawPools.length) {
-            return { content: [{ type: "text", text: "GeckoTerminal returned no pools. Try again in a moment." }], isError: true };
+        let candidates;
+        try {
+            candidates = await fetchBasePools(minLiquidity, limit);
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: err.message }], isError: true };
         }
-        // Deduplicate by pool id
-        const seen = new Set();
-        const pools = rawPools.filter(p => {
-            if (!p?.attributes || !p.id)
-                return false;
-            if (seen.has(p.id))
-                return false;
-            seen.add(p.id);
-            return true;
-        });
-        // Map GeckoTerminal pool → Candidate
-        const candidates = pools
-            .map((p) => {
-            const a = p.attributes ?? {};
-            const txns = a.transactions ?? {};
-            const pc = a.price_change_percentage ?? {};
-            const vol = a.volume_usd ?? {};
-            const liq = parseFloat(a.reserve_in_usd ?? "0");
-            const tokenRel = p.relationships?.base_token?.data?.id ?? "";
-            const mint = tokenRel.includes("_") ? tokenRel.split("_")[1] : tokenRel;
-            if (!mint?.startsWith("0x"))
-                return null;
-            return {
-                mint,
-                symbol: (a.name ?? "").split(" / ")[0] || mint.slice(0, 8),
-                priceUsd: parseFloat(a.base_token_price_usd ?? "0"),
-                priceChange5m: parseFloat(pc.m5 ?? "0"),
-                priceChange1h: parseFloat(pc.h1 ?? "0"),
-                priceChange6h: parseFloat(pc.h6 ?? "0"),
-                priceChange24h: parseFloat(pc.h24 ?? "0"),
-                volume1h: parseFloat(vol.h1 ?? "0"),
-                liquidity: liq,
-                buys5m: txns.m5?.buys ?? 0,
-                sells5m: txns.m5?.sells ?? 0,
-                buys1h: txns.h1?.buys ?? 0,
-                sells1h: txns.h1?.sells ?? 0,
-            };
-        })
-            .filter((c) => c !== null && c.liquidity >= minLiquidity)
-            .slice(0, limit);
         const scored = candidates
             .map(c => ({ ...c, ...scoreDipReversal(c, minLiquidity) }))
             .filter(c => c.passed && c.score >= minScore)
@@ -371,5 +450,57 @@ async function handleScannerTool(name, args) {
         lines.push(`Next steps: \`score_token\` for full breakdown · \`check_token\` for rug check before buying`);
         return { content: [{ type: "text", text: lines.join("\n") }] };
     }
+    // ── scan_momentum ──────────────────────────────────────────────────────────
+    if (name === "scan_momentum") {
+        const parsed = ScanMomentumSchema.safeParse(args ?? {});
+        if (!parsed.success)
+            return { content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }], isError: true };
+        const { minScore = DEFAULT_MIN_SCORE, minLiquidity = DEFAULT_MIN_LIQ, limit = 40 } = parsed.data;
+        let candidates;
+        try {
+            candidates = await fetchBasePools(minLiquidity, limit);
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: err.message }], isError: true };
+        }
+        const scored = candidates
+            .map(c => ({ ...c, ...scoreMomentum(c, minLiquidity) }))
+            .filter(c => c.passed && c.score >= minScore)
+            .sort((a, b) => b.score - a.score);
+        if (!scored.length) {
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `## Momentum Scan — No Breakouts Found`,
+                            ``,
+                            `Scanned **${candidates.length} pools** on Base. None passed the momentum gates with score ≥ ${minScore}.`,
+                            ``,
+                            `When nothing breaks out, the market may be in consolidation or distribution.`,
+                            ``,
+                            `Try: \`scan_dips\` to look for reversal opportunities instead.`,
+                        ].join("\n"),
+                    }],
+            };
+        }
+        const sign = (n) => n >= 0 ? `+${n.toFixed(1)}` : n.toFixed(1);
+        const lines = [
+            `## Momentum Scan — ${scored.length} Breakout${scored.length !== 1 ? "s" : ""} Found`,
+            `Scanned **${candidates.length} pools** · Score ≥ ${minScore} · Liq ≥ $${(minLiquidity / 1000).toFixed(0)}k`,
+            ``,
+        ];
+        for (const c of scored.slice(0, 10)) {
+            const bar = "█".repeat(Math.round(c.score / 10)).padEnd(10, "░");
+            lines.push(`### ${c.symbol} · ${c.score}/100 \`${bar}\``);
+            lines.push(`**Pattern:** ${c.pattern} · **Liq:** $${(c.liquidity / 1000).toFixed(0)}k · **1h:** ${sign(c.priceChange1h)}% · **5m:** ${sign(c.priceChange5m)}%`);
+            lines.push(`**Buy pressure:** ${c.buyPressure5m.toFixed(0)}% · **Vol 1h:** $${(c.volume1h / 1000).toFixed(0)}k`);
+            lines.push(`**Trend:** 6h ${sign(c.priceChange6h)}% / 24h ${sign(c.priceChange24h)}%`);
+            lines.push(`\`${c.mint}\``);
+            lines.push(``);
+        }
+        lines.push(`---`);
+        lines.push(`Next steps: \`score_token\` for dip-reversal score · \`check_token\` for rug check before buying`);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
     return null;
 }