@finchagentic/mcp 4.0.0 → 4.1.0

package/dist/tools/base-mcp.js

@@ -331,7 +331,7 @@ async function handleBaseMcpTool(name, args) {
         case "base_mcp_status": {
             // Combine chain stats + wallet address into one status snapshot
             const [chainRes, walletRes] = await Promise.all([
-                (0, base_js_1.handleBaseTool)("base_chain_stats", {}),
+                (0, base_js_1.handleBaseTool)("base_mcp_network", {}),
                 (0, wallet_js_1.handleWalletTool)("get_wallet_address", {}).catch(() => null),
             ]);
             const chainText = chainRes?.content?.[0]?.text ?? "Chain stats unavailable";
@@ -415,9 +415,9 @@ async function handleBaseMcpTool(name, args) {
             // Two parallel lookups - Morpho vaults + Moonwell markets - unless venue specified
             const promises = [];
             if (venue !== "moonwell")
-                promises.push((0, base_js_1.handleBaseTool)("base_query_vaults", { asset }));
+                promises.push((0, base_js_1.handleBaseTool)("base_mcp_yield_vaults", { asset }));
             if (venue !== "morpho")
-                promises.push((0, base_js_1.handleBaseTool)("base_list_markets", { asset }));
+                promises.push((0, base_js_1.handleBaseTool)("base_mcp_lending_rates", { asset }));
             const results = await Promise.all(promises);
             const blocks = results
                 .filter((r) => !!r && Array.isArray(r.content))
@@ -430,7 +430,7 @@ async function handleBaseMcpTool(name, args) {
             ];
             if (a.amount) {
                 // If amount provided, also prepare a deposit tx for the top option
-                const prep = await (0, base_js_1.handleBaseTool)("base_prepare_deposit", { asset, amount: a.amount });
+                const prep = await (0, base_js_1.handleBaseTool)("base_mcp_deposit_guide", { asset, amount: a.amount });
                 if (prep?.content?.[0]?.text) {
                     lines.push("", "### 📝 Prepared deposit", prep.content[0].text);
                 }

package/dist/tools/chronicle.js

@@ -10,7 +10,7 @@ const CHRONICLE_TYPES = ["vault", "memory", "agent", "tool", "automation", "moni
 exports.CHRONICLE_TOOLS = [
     {
         name: "chronicle_add",
-        description: "Log an event to Noel Chronicle - the system-wide audit log for your AI runtime. " +
+        description: "Log an event to Finch Chronicle - the system-wide audit log for your AI runtime. " +
             "Records anything meaningful: vault saves, agent updates, automation triggers, " +
             "custom milestones, research completions. Chronicle is your permanent timeline of what happened. " +
             "Types: vault | memory | agent | tool | automation | monitor | system | custom.",
@@ -40,7 +40,7 @@ exports.CHRONICLE_TOOLS = [
     },
     {
         name: "chronicle_list",
-        description: "Read the Noel Chronicle event log - your AI runtime timeline. Returns recent events in reverse chronological order. " +
+        description: "Read the Finch Chronicle event log - your AI runtime timeline. Returns recent events in reverse chronological order. " +
             "Filter by type to see only vault saves, agent activity, automations, etc.",
         inputSchema: {
             type: "object",
@@ -59,7 +59,7 @@ exports.CHRONICLE_TOOLS = [
     },
     {
         name: "chronicle_search",
-        description: "Search the Noel Chronicle by keyword. Matches against event titles and details. " +
+        description: "Search the Finch Chronicle by keyword. Matches against event titles and details. " +
             "Useful for finding when something specific happened: 'when did I last research ETH?' or 'find all vault saves for Base'.",
         inputSchema: {
             type: "object",
@@ -187,7 +187,7 @@ async function handleChronicle(name, args) {
             };
         }
         const lines = [
-            `## 📜 Noel Chronicle${type ? ` · ${type}` : ""}`,
+            `## 📜 Finch Chronicle${type ? ` · ${type}` : ""}`,
             `*${entries.length} event${entries.length !== 1 ? "s" : ""}*`,
             "",
         ];

package/dist/tools/deep-research.js

@@ -267,7 +267,7 @@ async function fcSearch(query, limit) {
     }
     // Backend-proxy path - session-authed; Finch covers Firecrawl cost.
     try {
-        const data = await (0, convex_js_1.callConvex)("/research/firecrawl-search", "POST", { query, limit }, "deep_research_search_proxy", 20000);
+        const data = await (0, convex_js_1.callConvex)("/research/firecrawl-search", "POST", { query, limit }, "web_search", 20000);
         return normalizeSearchHits(data?.results);
     }
     catch {
@@ -300,7 +300,7 @@ async function fcScrape(url) {
     // which means continueFrom can't auto-date proxied scrapes. Acceptable
     // tradeoff for now; markdown is the primary signal.
     try {
-        const data = await (0, convex_js_1.callConvex)("/research/firecrawl-scrape", "POST", { url }, "deep_research_scrape_proxy", 25000);
+        const data = await (0, convex_js_1.callConvex)("/research/firecrawl-scrape", "POST", { url }, "web_scrape", 25000);
         if (data?.markdown)
             return { markdown: data.markdown };
     }
@@ -568,7 +568,7 @@ async function synthesize(query, sources, isFinal, liveSearch, priorContext, fre
     let memoryContext = "";
     if (isFinal) {
         const [profileData, memHits] = await Promise.allSettled([
-            (0, convex_js_1.callConvex)("/vault/profile-context?maxChars=1200", "GET", undefined, "profile_context"),
+            (0, convex_js_1.callConvex)("/vault/profile-context?maxChars=1200", "GET", undefined, "vault_read"),
             (0, memory_js_1.searchSupermemory)(query, 4),
         ]);
         if (profileData.status === "fulfilled") {
@@ -744,7 +744,12 @@ Write the ${isFinal ? "final" : "draft"} report now. Markdown only - no preamble
     // pick for reasoning, JSON, code). Override via env or pass the same
     // model string to FINCH_MODEL to bypass.
     const researchModel = process.env.FINCH_RESEARCH_MODEL ?? "grok-4.3";
-    const raw = await (0, llm_js_1.callLLM)(sys, user, isFinal ? 4000 : 2000, [], 90000, { liveSearch, model: researchModel });
+    // Deep mode (critic notes present, or the 5-angle planner ran) produces a
+    // longer report than the standard 6-section template - a fixed 4000-token
+    // budget was cutting deep reports off mid-sentence around risk #6-7 of 13+.
+    const isDeepMode = !!criticNotes || (angles?.length ?? 0) >= 5;
+    const finalTokens = isDeepMode ? 7000 : 4000;
+    const raw = await (0, llm_js_1.callLLM)(sys, user, isFinal ? finalTokens : 2000, [], 90000, { liveSearch, model: researchModel });
     const { content: report, liveCitations } = extractLiveCitations(raw);
     // Citation density check - only for final reports. If the report has many
     // numerical claims but very few [N] citations, retry once with a stricter
@@ -757,7 +762,7 @@ Write the ${isFinal ? "final" : "draft"} report now. Markdown only - no preamble
 
 ⚠️ Your previous draft had ${density.numericalClaims} numerical claims but only ${density.citations} [N] citations. That ratio is too low. Rewrite with stricter citation density: every percentage, dollar amount, count, date, and named entity must carry [N]. Use the At a Glance table to anchor the key metrics.`;
         try {
-            const rawRetry = await (0, llm_js_1.callLLM)(sys, retryUser, 4000, [], 90000, { liveSearch, model: researchModel });
+            const rawRetry = await (0, llm_js_1.callLLM)(sys, retryUser, finalTokens, [], 90000, { liveSearch, model: researchModel });
             const { content: retryReport, liveCitations: retryCitations } = extractLiveCitations(rawRetry);
             return { report: retryReport, liveCitations: retryCitations.length > 0 ? retryCitations : liveCitations };
         }

package/dist/tools/defi.js

@@ -103,7 +103,7 @@ async function handleDefiTool(name, args) {
             // Pass the MCP local wallet as the swap taker so 0x routes output back
             // to the wallet that's signing - not the backend's custodial wallet.
             const localWallet = await (0, wallet_js_1.getOrCreateWallet)();
-            const result = await (0, convex_js_1.callConvex)("/mcp/defi/swap", "POST", { fromToken, toToken, amount, taker: localWallet.address, slippagePercentage: slippageLimit / 100 }, "estimate_swap");
+            const result = await (0, convex_js_1.callConvex)("/mcp/defi/swap", "POST", { fromToken, toToken, amount, taker: localWallet.address, slippagePercentage: slippageLimit / 100 }, "swap_tokens");
             if (!result.success)
                 return { content: [{ type: "text", text: `Estimate failed: ${result.error}` }], isError: true };
             const q = result.quote;
@@ -163,17 +163,25 @@ async function handleDefiTool(name, args) {
             }
             const txHash = await (0, wallet_js_1.signAndBroadcast)(wallet, q);
             const buyAmountHuman = formatTokenAmount(q.buyAmount, q.buyToken ?? toToken);
+            const receipt = await (0, wallet_js_1.waitForReceipt)(txHash);
+            const header = !receipt.mined
+                ? `⏳ Broadcast, not yet confirmed within the wait window.`
+                : receipt.ok
+                    ? `✅ Swap confirmed on-chain (block ${receipt.blockNumber}).`
+                    : `❌ Transaction REVERTED - no swap occurred (gas was still spent).`;
             return {
                 content: [{
                         type: "text",
                         text: [
-                            `✅ Swap executed!`,
-                            `${amount} ${fromToken.toUpperCase()} → ${buyAmountHuman} ${q.buyToken}`,
+                            header,
+                            `${amount} ${fromToken.toUpperCase()} → ${receipt.mined && receipt.ok ? buyAmountHuman : "(quoted, not received)"} ${q.buyToken}`,
                             `Slippage cap: ${slippageLimit}% · Price impact: ${impactPct.toFixed(3)}%`,
                             `Tx Hash: \`${txHash}\``,
                             `https://basescan.org/tx/${txHash}`,
-                        ].join("\n"),
+                            !receipt.mined ? `Check the link above before telling the user this succeeded or failed.` : "",
+                        ].filter(Boolean).join("\n"),
                     }],
+                isError: receipt.mined && !receipt.ok,
             };
         }
         case "send_token": {
@@ -186,11 +194,24 @@ async function handleDefiTool(name, args) {
             if (!result.success)
                 return { content: [{ type: "text", text: `Send failed: ${result.error}` }], isError: true };
             const txHash = await (0, wallet_js_1.signAndBroadcast)(wallet, result.txData);
+            const receipt = await (0, wallet_js_1.waitForReceipt)(txHash);
+            const header = !receipt.mined
+                ? `⏳ Broadcast, not yet confirmed within the wait window.`
+                : receipt.ok
+                    ? `✅ Sent - confirmed on-chain (block ${receipt.blockNumber}).`
+                    : `❌ Transaction REVERTED - funds were NOT sent (gas was still spent).`;
             return {
                 content: [{
                         type: "text",
-                        text: [`✅ Sent!`, `${amount} ${token.toUpperCase()} → \`${toAddress}\``, `Tx Hash: \`${txHash}\``, `https://basescan.org/tx/${txHash}`].join("\n"),
+                        text: [
+                            header,
+                            `${amount} ${token.toUpperCase()} → \`${toAddress}\``,
+                            `Tx Hash: \`${txHash}\``,
+                            `https://basescan.org/tx/${txHash}`,
+                            !receipt.mined ? `Check the link above before telling the user this succeeded or failed.` : "",
+                        ].filter(Boolean).join("\n"),
                     }],
+                isError: receipt.mined && !receipt.ok,
             };
         }
         case "analyze_wallet": {

package/dist/tools/insight.js

@@ -11,11 +11,11 @@ const signal_gate_js_1 = require("../signal-gate.js");
 exports.INSIGHT_TOOLS = [
     {
         name: "ask_finch",
-        description: "Ask Noel anything - analysis, opinions, explanations, strategy, or ideas. Noel loads your saved memory to personalize every answer. Use for: research questions, content ideas, code explanations, decision-making, DeFi analysis, trade ideas, or just thinking out loud. Pass previous messages to continue a conversation across tool calls.",
+        description: "Ask Finch anything - analysis, opinions, explanations, strategy, or ideas. Finch loads your saved memory to personalize every answer. Use for: research questions, content ideas, code explanations, decision-making, DeFi analysis, trade ideas, or just thinking out loud. Pass previous messages to continue a conversation across tool calls. If YOU are already a reasoning model (Claude, GPT, etc. calling this via MCP) and other tools already gave you the data you need, just answer directly instead of calling this - it runs a separate LLM call and won't tell you anything you can't already work out yourself from that data.",
         inputSchema: {
             type: "object",
             properties: {
-                question: { type: "string", description: "Your question or request for Noel" },
+                question: { type: "string", description: "Your question or request for Finch" },
                 messages: {
                     type: "array",
                     description: "Previous conversation messages for context (optional)",
@@ -63,7 +63,7 @@ exports.INSIGHT_TOOLS = [
         },
     },
 ];
-const AskNoelSchema = zod_1.z.object({
+const AskFinchSchema = zod_1.z.object({
     question: zod_1.z.string().min(1),
     messages: zod_1.z.array(zod_1.z.object({ role: zod_1.z.enum(["user", "assistant"]), content: zod_1.z.string() })).optional(),
 });
@@ -78,12 +78,12 @@ const TradePlanSchema = zod_1.z.object({
     riskTolerance: zod_1.z.enum(["conservative", "moderate", "aggressive"]).optional(),
     timeframe: zod_1.z.string().optional(),
 });
-const NOEL_BASE_PROMPT = `You are Noel, the core intelligence of the Finch runtime - the persistent state layer for AI assistants. You are direct, sharp, and thorough. You have access to memory that accumulates, vaults that version knowledge, agents that keep running between sessions, workflows that execute on schedule, plus execution domains: web research, market intelligence, code, and DeFi on Base. When asked anything, give your honest read backed by real reasoning. No filler, no disclaimers.
+const FINCH_BASE_PROMPT = `You are Finch, the core intelligence of the Finch runtime - the persistent state layer for AI assistants. You are direct, sharp, and thorough. You have access to memory that accumulates, vaults that version knowledge, agents that keep running between sessions, workflows that execute on schedule, plus execution domains: web research, market intelligence, code, and DeFi on Base. When asked anything, give your honest read backed by real reasoning. No filler, no disclaimers.
 
 When the user's vault or memory contains relevant prior research, build on it explicitly rather than starting from scratch. Reference vault entries by title when you cite them.`;
 async function searchVault(question, limit = 3) {
     try {
-        const data = await (0, convex_js_1.callConvex)("/vault/search", "POST", { query: question, limit }, "ask_finch_vault");
+        const data = await (0, convex_js_1.callConvex)("/vault/search", "POST", { query: question, limit }, "vault_search");
         const entries = data?.entries ?? data?.results ?? [];
         return Array.isArray(entries) ? entries.slice(0, limit) : [];
     }
@@ -93,7 +93,7 @@ async function searchVault(question, limit = 3) {
 }
 async function fetchProfileContext() {
     try {
-        const data = await (0, convex_js_1.callConvex)("/vault/profile-context?maxChars=3000", "GET", undefined, "profile_context");
+        const data = await (0, convex_js_1.callConvex)("/vault/profile-context?maxChars=3000", "GET", undefined, "vault_read");
         return (data?.context ?? "").trim();
     }
     catch {
@@ -138,8 +138,8 @@ async function buildSystemPrompt(question) {
         blocks.push(`<user_vault>\nThe user already has these prior artifacts on closely related topics - build on them, don't repeat them:\n${vaultBlock}\n</user_vault>`);
     }
     const prompt = blocks.length === 0
-        ? NOEL_BASE_PROMPT
-        : `${NOEL_BASE_PROMPT}\n\n${blocks.join("\n\n")}`;
+        ? FINCH_BASE_PROMPT
+        : `${FINCH_BASE_PROMPT}\n\n${blocks.join("\n\n")}`;
     return { prompt, meta };
 }
 function formatContextHeader(meta) {
@@ -391,7 +391,7 @@ function spreadNote(priceData) {
 }
 async function handleInsightTool(name, args) {
     if (name === "ask_finch") {
-        const parsed = AskNoelSchema.safeParse(args);
+        const parsed = AskFinchSchema.safeParse(args);
         if (!parsed.success)
             return { content: [{ type: "text", text: `Invalid input: question ${parsed.error.issues[0].message}` }], isError: true };
         const { question, messages = [] } = parsed.data;
@@ -419,25 +419,21 @@ async function handleInsightTool(name, args) {
                 systemPrompt += `\n\nCRITICAL: User is asking about a current price but no live data was retrieved. Reply honestly: "I don't have a live price quote right now - check CoinGecko or DexScreener directly." DO NOT state any specific price number. DO NOT recall a price from training data.`;
             }
         }
-        let answer = null;
-        if (process.env.BANKR_API_KEY || process.env.ANTHROPIC_API_KEY) {
-            try {
-                const history = messages.map(m => ({ role: m.role, content: m.content }));
-                answer = await (0, llm_js_1.callLLM)(systemPrompt, question, 1024, history);
-            }
-            catch {
-                // fall through to Convex backend
-            }
-        }
-        if (!answer) {
-            const data = await (0, convex_js_1.callConvex)("/mcp/chat", "POST", {
-                question,
-                agentId: "noel-default",
-                messages,
-                systemPrompt,
-            }, "ask_finch");
-            answer = data.answer ?? JSON.stringify(data);
+        if (!(0, llm_js_1.hasDirectLLMKey)()) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "ask_finch needs its own LLM key to reason server-side - set one of " +
+                            "BANKR_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, or GROK_API_KEY as an " +
+                            "environment variable, then retry. If YOU (the calling model) already have " +
+                            "the context needed to answer this, just answer directly instead - that's " +
+                            "usually faster and doesn't need a key at all.",
+                    }],
+                isError: true,
+            };
         }
+        const history = messages.map(m => ({ role: m.role, content: m.content }));
+        const answer = await (0, llm_js_1.callLLM)(systemPrompt, question, 1024, history);
         // Signal gate - if the model returned thin/meta output, flag it so the
         // user knows to retry with more specific framing or use deep_research.
         const signal = (0, signal_gate_js_1.checkSignal)(answer);

package/dist/tools/memory.js

@@ -101,7 +101,7 @@ async function findDuplicateMemory(hash) {
         const local = (0, local_memory_js_1.getLocalMemoryConfig)();
         const results = local
             ? await (0, local_memory_js_1.localMemoryList)(local, 50)
-            : ((await (0, convex_js_1.callConvex)("/memory/list", "POST", { n: 50 }))?.results ?? []);
+            : ((await (0, convex_js_1.callConvex)("/memory/list", "POST", { n: 50 }, "memory_list"))?.results ?? []);
         const match = results.find((r) => r.metadata?.contentHash === hash);
         if (!match)
             return null;
@@ -154,7 +154,7 @@ async function syncToSupermemory(content, metadata, sourceUrl) {
     };
     for (let attempt = 0; attempt <= SYNC_RETRY_DELAYS_MS.length; attempt++) {
         try {
-            await (0, convex_js_1.callConvex)("/memory/add", "POST", payload);
+            await (0, convex_js_1.callConvex)("/memory/add", "POST", payload, "memory_add");
             return;
         }
         catch (err) {
@@ -183,7 +183,7 @@ async function searchSupermemory(query, limit = 10) {
         const local = (0, local_memory_js_1.getLocalMemoryConfig)();
         if (local)
             return await (0, local_memory_js_1.localMemorySearch)(local, query, limit);
-        const data = await (0, convex_js_1.callConvex)("/memory/search", "POST", { q: query, n: limit });
+        const data = await (0, convex_js_1.callConvex)("/memory/search", "POST", { q: query, n: limit }, "memory_search");
         return data?.results ?? [];
     }
     catch {
@@ -195,7 +195,7 @@ async function searchSupermemory(query, limit = 10) {
 // directly without re-normalizing raw scores.
 async function lexicalSearch(query, limit = 30) {
     try {
-        const data = await (0, convex_js_1.callConvex)("/memory/lexical", "POST", { q: query, n: limit });
+        const data = await (0, convex_js_1.callConvex)("/memory/lexical", "POST", { q: query, n: limit }, "memory_search");
         const rows = (data?.results ?? []);
         return rows.map((r, idx) => ({
             id: r.id,
@@ -284,12 +284,13 @@ async function hybridMemorySearch(query, limit = 30) {
 exports.MEMORY_TOOLS = [
     {
         name: "memory_add",
-        description: "Add content to your Finch semantic memory - no setup needed, no extra API keys. " +
+        description: "Add content to your Finch memory - no setup needed, no extra API keys. " +
             "Unlike vault_save, memory_add is instant: no versioning, no type required. " +
-            "Use for notes, decisions, preferences, or anything you want to find later with natural language. " +
+            "Use for notes, decisions, preferences, or anything you want to find later. " +
             "Pass sourceUrl to fetch and index any web page, GitHub repo, or Notion page automatically - " +
-            "searchable in ~30s. Memory is indexed semantically - 'what did I say about ETH yield?' " +
-            "will find it even without exact keywords. " +
+            "searchable in ~30s. Retrieval is full-text (keyword) search, not embeddings - " +
+            "'what did I say about ETH yield?' finds notes containing those words or close variants, " +
+            "not unrelated phrasing with the same meaning. " +
             "Auto-deduplicates: identical content in your recent 50 memories is skipped (override with force:true).",
         inputSchema: {
             type: "object",
@@ -305,10 +306,11 @@ exports.MEMORY_TOOLS = [
     },
     {
         name: "memory_search",
-        description: "Hybrid memory search - fuses semantic (embedding) + lexical (full-text BM25) retrieval via Reciprocal Rank Fusion. " +
-            "Catches both meaning matches ('low risk crypto yield' → 'conservative DeFi strategies') and exact-token lookups (env var names, contract addresses, IDs) that pure semantic search misses. " +
-            "90-day time-decay weighting on top so recent precise notes outrank stale ones. " +
-            "Falls back to semantic-only for memories added before v3.24 (no lexical mirror).",
+        description: "Full-text (keyword) search over your stored memories, with 90-day time-decay weighting so " +
+            "recent notes outrank stale ones with similar wording. Good for exact-token lookups (env var " +
+            "names, contract addresses, IDs, specific phrases) - it does not understand meaning, so " +
+            "'low risk crypto yield' will not match a note phrased as 'conservative DeFi strategies' " +
+            "unless the words themselves overlap.",
         inputSchema: {
             type: "object",
             properties: {
@@ -320,9 +322,10 @@ exports.MEMORY_TOOLS = [
     },
     {
         name: "memory_context",
-        description: "Retrieve the most semantically relevant memories for a topic, formatted as AI-ready context. " +
+        description: "Retrieve the most relevant memories for a topic, formatted as AI-ready context. " +
             "Use at the start of research tasks to prime with everything stored about a topic. " +
-            "Uses vector search - finds semantically related content, not just exact keyword matches.",
+            "Uses full-text (keyword) search, not embeddings - phrase your topic with the words " +
+            "you expect were actually used when the memory was saved.",
         inputSchema: {
             type: "object",
             properties: {
@@ -334,7 +337,7 @@ exports.MEMORY_TOOLS = [
     },
     {
         name: "memory_profile",
-        description: "Show your semantic memory stats - total memories stored, your memory space, and connected sources. " +
+        description: "Show your memory stats - total memories stored, your memory space, and connected sources. " +
             "Useful for auditing what Finch knows about you.",
         inputSchema: {
             type: "object",
@@ -373,7 +376,7 @@ exports.MEMORY_TOOLS = [
     },
     {
         name: "memory_insight",
-        description: "Get a full intelligence report on any topic - combines semantic memory AND vault entries, " +
+        description: "Get a full intelligence report on any topic - combines memory AND vault entries, " +
             "then identifies knowledge gaps and suggests next actions. " +
             "Use this before starting any research or trade decision to see everything Finch already knows. " +
             "Returns: confidence level, what you know, coverage timeline, gaps, and recommended next steps.",
@@ -388,7 +391,7 @@ exports.MEMORY_TOOLS = [
     },
     {
         name: "memory_extract",
-        description: "Save discrete facts, preferences and decisions to semantic memory as individually searchable atoms " +
+        description: "Save discrete facts, preferences and decisions to memory as individually searchable atoms " +
             "instead of one wall of text. Two-pass, no API key needed. " +
             "PASS 1 — call with `text`: returns the text with the extraction rubric. " +
             "PASS 2 — call with `facts: [...]`: stores each fact separately, deduped. " +
@@ -560,7 +563,7 @@ async function handleMemoryTool(name, args) {
             const localAdd = (0, local_memory_js_1.getLocalMemoryConfig)();
             const data = localAdd
                 ? await (0, local_memory_js_1.localMemoryAdd)(localAdd, content, addMetadata, sourceUrl).catch((err) => ({ error: err.message }))
-                : await (0, convex_js_1.callConvex)("/memory/add", "POST", { content, metadata: addMetadata, ...(sourceUrl ? { sourceUrl } : {}) }).catch((err) => ({ error: err.message }));
+                : await (0, convex_js_1.callConvex)("/memory/add", "POST", { content, metadata: addMetadata, ...(sourceUrl ? { sourceUrl } : {}) }, "memory_add").catch((err) => ({ error: err.message }));
             if (data?.error)
                 return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
             // Cache the hash so an immediate second call with identical content
@@ -588,11 +591,12 @@ async function handleMemoryTool(name, args) {
             const { query, limit = 10 } = parsed.data;
             // Over-fetch so post-decay ranking still has enough material.
             const overfetch = Math.min(50, Math.max(limit * 2, 20));
-            // ─── Hybrid retrieval ────────────────────────────────────────────
-            // Fan out semantic (Supermemory embedding) + lexical (Convex full-text)
-            // in parallel, fuse via Reciprocal Rank Fusion. Falls back gracefully:
-            // if lexical is empty (e.g. user has only pre-v3.24 memories) the
-            // fused list equals semantic.
+            // ─── Retrieval ───────────────────────────────────────────────────
+            // Fan out two full-text queries (searchSupermemory and lexicalSearch -
+            // both call Convex full-text search under different names, there is no
+            // embedding step despite the "semantic"/"Supermemory" naming) in
+            // parallel, fuse via Reciprocal Rank Fusion so results present in both
+            // rank highest.
             const fused = await hybridMemorySearch(query, overfetch);
             const raw = fused;
             if (!raw.length)
@@ -697,7 +701,7 @@ async function handleMemoryTool(name, args) {
             const localProfileCfg = (0, local_memory_js_1.getLocalMemoryConfig)();
             const data = localProfileCfg
                 ? await (0, local_memory_js_1.localMemoryProfile)(localProfileCfg).catch(() => null)
-                : await (0, convex_js_1.callConvex)("/memory/profile", "GET").catch(() => null);
+                : await (0, convex_js_1.callConvex)("/memory/profile", "GET", undefined, "memory_profile").catch(() => null);
             const total = data?.total ?? 0;
             const status = data?.status ?? "unknown";
             const space = data?.space ?? "-";
@@ -738,7 +742,7 @@ async function handleMemoryTool(name, args) {
                 }
             }
             else {
-                const data = await (0, convex_js_1.callConvex)("/memory/list", "POST", { n: limit, tag }).catch((err) => ({ error: err.message }));
+                const data = await (0, convex_js_1.callConvex)("/memory/list", "POST", { n: limit, tag }, "memory_list").catch((err) => ({ error: err.message }));
                 if (data?.error)
                     return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
                 results = data?.results ?? [];
@@ -777,7 +781,7 @@ async function handleMemoryTool(name, args) {
                 }
             }
             else {
-                const data = await (0, convex_js_1.callConvex)("/memory/delete", "POST", { id: parsed.data.id }).catch((err) => ({ error: err.message }));
+                const data = await (0, convex_js_1.callConvex)("/memory/delete", "POST", { id: parsed.data.id }, "memory_delete").catch((err) => ({ error: err.message }));
                 if (data?.error)
                     return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
             }
@@ -794,7 +798,7 @@ async function handleMemoryTool(name, args) {
             // matches. Vault side runs in parallel as before.
             const [memResults, vaultData] = await Promise.all([
                 hybridMemorySearch(topic, memLimit),
-                (0, convex_js_1.callConvex)(`/vault/search?q=${encodeURIComponent(topic)}&limit=6`, "GET", undefined, "memory_insight").catch(() => ({ results: [] })),
+                (0, convex_js_1.callConvex)(`/vault/search?q=${encodeURIComponent(topic)}&limit=6`, "GET", undefined, "vault_search").catch(() => ({ results: [] })),
             ]);
             const vaultResults = vaultData.results ?? [];
             const total = memResults.length + vaultResults.length;
@@ -905,7 +909,7 @@ async function handleMemoryTool(name, args) {
             const metaFor = () => ({ source, addedAt: Date.now() });
             const results = await Promise.allSettled(facts.map((fact) => localExtractCfg
                 ? (0, local_memory_js_1.localMemoryAdd)(localExtractCfg, fact, metaFor())
-                : (0, convex_js_1.callConvex)("/memory/add", "POST", { content: fact, metadata: metaFor() })));
+                : (0, convex_js_1.callConvex)("/memory/add", "POST", { content: fact, metadata: metaFor() }, "memory_add")));
             const saved = results.filter((r) => r.status === "fulfilled").length;
             const failed = results.length - saved;
             return {
@@ -934,7 +938,7 @@ async function handleMemoryTool(name, args) {
                 const meta = { title: `Consolidated: ${topic}`, source: "memory_consolidate", addedAt: Date.now() };
                 const saved = localConsolidateCfg
                     ? await (0, local_memory_js_1.localMemoryAdd)(localConsolidateCfg, summary, meta).catch((err) => ({ error: err.message }))
-                    : await (0, convex_js_1.callConvex)("/memory/add", "POST", { content: summary, metadata: meta }).catch((err) => ({ error: err.message }));
+                    : await (0, convex_js_1.callConvex)("/memory/add", "POST", { content: summary, metadata: meta }, "memory_add").catch((err) => ({ error: err.message }));
                 if (saved?.error) {
                     return { content: [{ type: "text", text: `Error saving consolidated memory: ${saved.error}` }], isError: true };
                 }

package/dist/tools/monitor.js

@@ -117,7 +117,7 @@ async function handleMonitorTool(name, args) {
         // created 4× by an over-eager agent loop, which is what produced the
         // duplicate Telegram briefings users complained about.
         try {
-            const existingMonitors = await (0, convex_js_1.callConvex)("/vault/list", "POST", { type: "workflow", tags: ["monitor-config"] }, "list_monitors_for_dedup");
+            const existingMonitors = await (0, convex_js_1.callConvex)("/vault/list", "POST", { type: "workflow", tags: ["monitor-config"] }, "vault_list");
             const duplicates = (existingMonitors?.entries ?? []).filter((e) => {
                 try {
                     const cfg = JSON.parse(e.content ?? "{}");

package/dist/tools/os.js

@@ -45,14 +45,14 @@ async function handleOsTool(name, args) {
             const localStatusCfg = (0, local_memory_js_1.getLocalMemoryConfig)();
             const memoryProfileCall = localStatusCfg
                 ? (0, local_memory_js_1.localMemoryProfile)(localStatusCfg)
-                : (0, convex_js_1.callConvex)("/memory/profile", "GET");
+                : (0, convex_js_1.callConvex)("/memory/profile", "GET", undefined, "memory_profile");
             const [tierResult, walletResult, memRes, autoRes, vaultRes, agentsRes] = await Promise.allSettled([
                 (0, token_gate_js_1.getTier)(),
                 (0, wallet_js_1.getOrCreateWallet)(),
                 memoryProfileCall,
                 (0, convex_js_1.callConvex)("/automations/list", "GET", undefined, "list_automations"),
-                (0, convex_js_1.callConvex)("/vault/list?type=research&limit=5", "GET", undefined, "finch_status"),
-                (0, convex_js_1.callConvex)("/vault/list?type=memory&limit=20", "GET", undefined, "finch_status"),
+                (0, convex_js_1.callConvex)("/vault/list?type=research&limit=5", "GET", undefined, "vault_list"),
+                (0, convex_js_1.callConvex)("/vault/list?type=memory&limit=20", "GET", undefined, "vault_list"),
             ]);
             const tier = tierResult.status === "fulfilled" ? tierResult.value : "basic";
             const wallet = walletResult.status === "fulfilled" ? walletResult.value : null;
@@ -171,8 +171,13 @@ async function handleOsTool(name, args) {
                 hints.push(`→ No FIRECRAWL_API_KEY — deep_research falls back to Finch proxy (requires session token).`);
             if (!localMemCfg)
                 hints.push(`→ Memory tools use the Finch-hosted proxy. Run \`finch setup\` for free, self-hosted local memory.`);
-            else if (localSmStatus !== "ok")
+            else if (localMemCfg.kind === "supermemory" && localSmStatus !== "ok")
                 hints.push(`→ Local memory configured but ${localMemCfg.url} isn't reachable — memory tools will fail. Run \`npx -y supermemory local\`.`);
+            const localMemLabel = !localMemCfg
+                ? "not configured — run `finch setup`"
+                : localMemCfg.kind === "file"
+                    ? "file-based at ~/.finch/memory"
+                    : localSmStatus === "ok" ? `reachable at ${localMemCfg.url}` : `configured but unreachable at ${localMemCfg.url}`;
             const lines = [
                 `## 🩺 Finch Diagnostics`,
                 ``,
@@ -180,7 +185,7 @@ async function handleOsTool(name, args) {
                 `  ${statusIcon(convexStatus)}  Convex backend       ${convexStatus === "ok" ? "reachable" : "unreachable — check FINCH_CONVEX_URL"}`,
                 `  ${statusIcon(fcStatus)}  Firecrawl            ${fcStatus === "ok" ? "reachable" : fcStatus === "unconfigured" ? "no FIRECRAWL_API_KEY — deep_research will use proxy" : "unreachable"}`,
                 `  ${statusIcon(smStatus)}  Supermemory (cloud)  ${localMemCfg ? "not used — local memory active" : smStatus === "ok" ? "reachable" : "unreachable — memory tools may fail"}`,
-                `  ${statusIcon(localSmStatus)}  Supermemory (local)  ${localMemCfg ? (localSmStatus === "ok" ? `reachable at ${localMemCfg.url}` : `configured but unreachable at ${localMemCfg.url}`) : "not configured — run `finch setup`"}`,
+                `  ${statusIcon(localSmStatus)}  Local memory         ${localMemLabel}`,
                 ``,
                 `**API Keys configured:** _(none of the LLM keys are required — see below)_`,
                 ...Object.entries(envKeys).map(([k, v]) => `  ${v ? "✅" : "⚪"}  ${k}`),

package/dist/tools/packets.js

@@ -134,7 +134,7 @@ async function handlePacket(toolName, args) {
             content,
             contentType: "json",
             tags: ["packet", ...(tags ?? [])],
-        }, "packet_create");
+        }, "vault_save");
         return {
             content: [{
                     type: "text",
@@ -153,7 +153,7 @@ async function handlePacket(toolName, args) {
     }
     if (toolName === "packet_run") {
         const { name } = args;
-        const data = await (0, convex_js_1.callConvex)(`/vault/entry?key=${encodeURIComponent(packetKey(name))}`, "GET", undefined, "packet_run");
+        const data = await (0, convex_js_1.callConvex)(`/vault/entry?key=${encodeURIComponent(packetKey(name))}`, "GET", undefined, "vault_read");
         if (!data?.content || data?.error) {
             return {
                 content: [{ type: "text", text: `Packet \`${name}\` not found. Use \`packet_list\` to see available packets.` }],
@@ -271,7 +271,7 @@ async function handlePacket(toolName, args) {
         const data = await (0, convex_js_1.callConvex)("/vault/publish", "POST", {
             key: packetKey(name),
             authorName: authorName ?? "anonymous",
-        }, "packet_share");
+        }, "vault_publish");
         if (data.error)
             return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
         return {

package/dist/tools/research.js

@@ -68,7 +68,7 @@ async function firecrawlScrape(url) {
     // FIRECRAWL_API_KEY set either, in which case web_scrape silently falls
     // through to basicFetch below.
     try {
-        const data = await (0, convex_js_1.callConvex)("/research/firecrawl-scrape", "POST", { url }, "web_scrape_proxy", 25000);
+        const data = await (0, convex_js_1.callConvex)("/research/firecrawl-scrape", "POST", { url }, "web_scrape", 25000);
         if (data?.markdown)
             return data.markdown;
     }
@@ -149,7 +149,7 @@ async function handleResearchTool(name, args) {
         }
         if (!results) {
             try {
-                const data = await (0, convex_js_1.callConvex)("/research/firecrawl-search", "POST", { query, limit }, "web_search_proxy", 30000);
+                const data = await (0, convex_js_1.callConvex)("/research/firecrawl-search", "POST", { query, limit }, "web_search", 30000);
                 results = data?.results ?? [];
             }
             catch (err) {

package/dist/tools/rh-mcp.js

@@ -33,6 +33,15 @@ exports.RH_EXPLORER = "https://robinhoodchain.blockscout.com";
 const NATIVE_ETH = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
 const RH_PERMIT2 = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
 const RH_UNIVERSAL_ROUTER = "0x8876789976decbfcbbbe364623c63652db8c0904";
+/**
+ * Canonical Global Dollar (USDG) — RH chain's settlement stablecoin (same
+ * address as app/convex/_settlement.ts). Hardcoded rather than resolved via
+ * DexScreener ticker search: "USDG" is the exact symbol an imposter contract
+ * would spoof, and dexSearchByTicker ranks by pool liquidity, not authenticity
+ * — a fake pool with inflated liquidity could otherwise outrank the real token.
+ */
+const USDG_ADDRESS = "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168";
+const USDG_DECIMALS = 6;
 /** ClawHood / Finch catalog (22 tokenized stocks — official "Robinhood Token" contracts). */
 exports.RH_STOCKS = [
     { address: "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", symbol: "AAPL", name: "Apple" },
@@ -336,6 +345,9 @@ async function resolveTokenSmart(input) {
     if (isEth(input))
         return { kind: "eth", address: NATIVE_ETH, symbol: "ETH", decimals: 18 };
     const t = input.trim();
+    if (t.toUpperCase() === "USDG") {
+        return { kind: "token", address: USDG_ADDRESS, symbol: "USDG", name: "Global Dollar", decimals: USDG_DECIMALS };
+    }
     // 1) catalog symbol fast-path (22 tokenized stocks, all 18-decimals)
     const cat = exports.RH_STOCKS.find((s) => s.symbol === t.toUpperCase());
     if (cat)