@finchagentic/mcp 4.6.1 → 4.6.2

package/dist/llm.js

@@ -1,298 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasDirectLLMKey = hasDirectLLMKey;
-exports.grokLiveSearchHits = grokLiveSearchHits;
-exports.isGrokActive = isGrokActive;
-exports.callLLM = callLLM;
-const ANTHROPIC_URL = "https://api.anthropic.com/v1/messages";
-const BANKR_URL = "https://llm.bankr.bot/v1/chat/completions";
-const GROK_URL = "https://api.x.ai/v1/chat/completions";
-const OPENAI_URL = "https://api.openai.com/v1/chat/completions";
-/**
- * Returns true if Grok is the currently active LLM provider, based on env.
- * Useful for tools that want to conditionally enable Grok-specific features
- * like Live Search.
- */
-/**
- * True if any BYOK provider key (Bankr/Anthropic/OpenAI/Grok) is set. Callers
- * that must never fall through to callViaConvex() - e.g. local-memory mode,
- * which promises zero Convex involvement - should check this first and fail
- * clearly instead of letting callLLM() silently proxy through Finch.
- */
-function hasDirectLLMKey() {
-    return !!(process.env.BANKR_API_KEY || process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || process.env.GROK_API_KEY);
-}
-/**
- * Grok Live Search used purely as a RETRIEVAL layer.
- *
- * X/news content is the one thing an MCP client genuinely cannot reach on its
- * own, which makes fetching it real tool work. Interpreting it is not — so this
- * asks Grok to return the found items verbatim and hands them upward as sources.
- * The caller's model decides what any of it means.
- *
- * Returns [] on any failure: live search is an augmentation, never a hard
- * dependency, and research must still work without a Grok key.
- */
-async function grokLiveSearchHits(query, sources = ["x", "news", "web"], days, maxResults = 10) {
-    const apiKey = process.env.GROK_API_KEY;
-    if (!apiKey)
-        return [];
-    const body = {
-        model: process.env.FINCH_GROK_MODEL ?? "grok-4.3",
-        max_tokens: 2000,
-        messages: [
-            {
-                role: "system",
-                content: "You are a retrieval tool, not an analyst. Return what you find verbatim. " +
-                    "Never summarise, interpret, rank by opinion, or add commentary.",
-            },
-            {
-                role: "user",
-                content: `Search for: ${query}\n\n` +
-                    `Return up to ${maxResults} of the most relevant recent items, one per line, ` +
-                    `in exactly this format:\n\n` +
-                    `URL :: verbatim quote or post text (max 400 chars)\n\n` +
-                    `Rules: quote the source's own words. Do not paraphrase. Do not add analysis, ` +
-                    `conclusions, or your own framing. If an item has no URL, use "-" for the URL.`,
-            },
-        ],
-        search_parameters: {
-            mode: "on",
-            sources: sources.map((type) => ({ type })),
-            max_search_results: maxResults,
-            ...(days ? { from_date: new Date(Date.now() - days * 86400000).toISOString().slice(0, 10) } : {}),
-        },
-    };
-    try {
-        const res = await fetch(GROK_URL, {
-            method: "POST",
-            headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
-            body: JSON.stringify(body),
-            signal: AbortSignal.timeout(45000),
-        });
-        if (!res.ok)
-            return [];
-        const data = (await res.json());
-        const content = data.choices?.[0]?.message?.content ?? "";
-        const hits = [];
-        for (const line of content.split("\n")) {
-            const idx = line.indexOf("::");
-            if (idx === -1)
-                continue;
-            const url = line.slice(0, idx).trim().replace(/^[-*\d.\s]+/, "");
-            const excerpt = line.slice(idx + 2).trim();
-            if (excerpt.length < 20)
-                continue;
-            hits.push({ url: /^https?:\/\//.test(url) ? url : "", excerpt });
-        }
-        // If the model ignored the format, fall back to bare citations so the
-        // caller still receives the URLs rather than nothing.
-        if (hits.length === 0 && data.citations?.length) {
-            return data.citations.slice(0, maxResults).map((url) => ({ url, excerpt: "" }));
-        }
-        return hits.slice(0, maxResults);
-    }
-    catch {
-        return [];
-    }
-}
-function isGrokActive() {
-    const provider = process.env.FINCH_PROVIDER?.toLowerCase().trim();
-    if (provider === "grok")
-        return !!process.env.GROK_API_KEY;
-    if (provider === "bankr" || provider === "anthropic" || provider === "openai")
-        return false;
-    // Auto-priority - Grok is only active if it's the only key present
-    if (process.env.BANKR_API_KEY || process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY)
-        return false;
-    return !!process.env.GROK_API_KEY;
-}
-/**
- * Call the best available LLM.
- *
- * Provider auto-priority (when FINCH_PROVIDER unset):
- *   BANKR_API_KEY → ANTHROPIC_API_KEY → OPENAI_API_KEY → GROK_API_KEY → Convex backend
- *
- * Force a provider via FINCH_PROVIDER: "bankr" | "anthropic" | "openai" | "grok"
- *
- * Model selection (first wins):
- *   FINCH_MODEL → {provider}_MODEL → provider default
- */
-async function callLLM(systemPrompt, userPrompt, maxTokens = 1024, history = [], timeoutMs = 60000, options = {}) {
-    const provider = process.env.FINCH_PROVIDER?.toLowerCase().trim();
-    const bankrKey = process.env.BANKR_API_KEY;
-    const anthropicKey = process.env.ANTHROPIC_API_KEY;
-    const openaiKey = process.env.OPENAI_API_KEY;
-    const grokKey = process.env.GROK_API_KEY;
-    // Explicit provider override - user picked one
-    if (provider === "grok" && grokKey)
-        return callGrok(grokKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.liveSearch, options.model);
-    if (provider === "anthropic" && anthropicKey)
-        return callAnthropic(anthropicKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.model);
-    if (provider === "openai" && openaiKey)
-        return callOpenAI(openaiKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.model);
-    if (provider === "bankr" && bankrKey)
-        return callBankr(bankrKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.model);
-    // Auto priority
-    if (bankrKey)
-        return callBankr(bankrKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.model);
-    if (anthropicKey)
-        return callAnthropic(anthropicKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.model);
-    if (openaiKey)
-        return callOpenAI(openaiKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.model);
-    if (grokKey)
-        return callGrok(grokKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, options.liveSearch, options.model);
-    // No provider key configured - BYOK is required. This tool needs its own
-    // multi-step reasoning (planning, synthesis, critique) that an MCP host's
-    // model cannot do on the tool's behalf, so there is no free path: bring
-    // your own key or don't use tools that need one (ask_finch, deep_research,
-    // market_thesis, trade_plan, scheduled agent runs). Fails clearly instead
-    // of silently billing the Finch deployment owner for every anonymous
-    // install of this package.
-    throw new Error("No LLM provider configured. This tool needs its own key to do multi-step " +
-        "reasoning server-side - set one of BANKR_API_KEY, ANTHROPIC_API_KEY, " +
-        "OPENAI_API_KEY, or GROK_API_KEY as an environment variable (see the " +
-        "Configuration section of the README), then retry. Most other Finch tools " +
-        "don't need this - only ones that do their own internal LLM reasoning do.");
-}
-async function callAnthropic(apiKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, modelOverride) {
-    const messages = [...history, { role: "user", content: userPrompt }];
-    const model = modelOverride ?? process.env.FINCH_MODEL ?? process.env.ANTHROPIC_MODEL ?? "claude-haiku-4-5-20251001";
-    const res = await fetch(ANTHROPIC_URL, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            "x-api-key": apiKey,
-            "anthropic-version": "2023-06-01",
-        },
-        body: JSON.stringify({ model, max_tokens: maxTokens, system: systemPrompt, messages }),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    if (!res.ok) {
-        const body = await res.text().catch(() => "");
-        throw new Error(`Anthropic error ${res.status}: ${body.slice(0, 200)}`);
-    }
-    const data = await res.json();
-    return data.content?.find(b => b.type === "text")?.text ?? "";
-}
-async function callBankr(apiKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, modelOverride) {
-    const model = modelOverride ?? process.env.FINCH_MODEL ?? process.env.BANKR_MODEL ?? "claude-haiku-4-5-20251001";
-    const res = await fetch(BANKR_URL, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", "X-API-Key": apiKey },
-        body: JSON.stringify({
-            model,
-            messages: [
-                { role: "system", content: systemPrompt },
-                ...history,
-                { role: "user", content: userPrompt },
-            ],
-            max_tokens: maxTokens,
-        }),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    if (!res.ok) {
-        const body = await res.text().catch(() => "");
-        throw new Error(`Bankr error ${res.status}: ${body.slice(0, 200)}`);
-    }
-    const data = await res.json();
-    return data.choices?.[0]?.message?.content ?? "";
-}
-// OPENAI_BASE_URL lets this point at any OpenAI Chat Completions-compatible
-// endpoint instead of api.openai.com - self-hosted gateways (LiteLLM, vLLM,
-// Ollama, LocalAI) and aggregators (OpenRouter) all speak this same API
-// shape, so no separate provider code is needed for them.
-function openAiChatUrl() {
-    const base = process.env.OPENAI_BASE_URL?.replace(/\/+$/, "");
-    return base ? `${base}/chat/completions` : OPENAI_URL;
-}
-async function callOpenAI(apiKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, modelOverride) {
-    const model = modelOverride ?? process.env.FINCH_MODEL ?? process.env.OPENAI_MODEL ?? "gpt-4o-mini";
-    const res = await fetch(openAiChatUrl(), {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
-        body: JSON.stringify({
-            model,
-            messages: [
-                { role: "system", content: systemPrompt },
-                ...history,
-                { role: "user", content: userPrompt },
-            ],
-            max_tokens: maxTokens,
-        }),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    if (!res.ok) {
-        const body = await res.text().catch(() => "");
-        throw new Error(`OpenAI error ${res.status}: ${body.slice(0, 200)}`);
-    }
-    const data = await res.json();
-    // Most OpenAI-compatible gateways put `choices` at the top level, but
-    // OPENAI_BASE_URL can point at anything that speaks this API shape - at
-    // least one (9Router) wraps the whole payload in `{ data: {...}, success:
-    // true }` for some models (confirmed live: routers9/glm5.2 returns this
-    // wrapper while routers9/tencent/hy3 on the SAME endpoint/key returns
-    // top-level choices). Without this fallback the call silently returns ""
-    // instead of throwing - worse than an error, since every caller of
-    // callLLM() just gets an empty synthesis with no indication anything failed.
-    const content = data.choices?.[0]?.message?.content ?? data.data?.choices?.[0]?.message?.content;
-    if (!content)
-        throw new Error(`OpenAI-compatible endpoint returned no content (model: ${model})`);
-    return content;
-}
-async function callGrok(apiKey, systemPrompt, userPrompt, maxTokens, history, timeoutMs, liveSearch, modelOverride) {
-    const model = modelOverride ?? process.env.FINCH_MODEL ?? process.env.GROK_MODEL ?? "grok-4-fast-reasoning";
-    const body = {
-        model,
-        messages: [
-            { role: "system", content: systemPrompt },
-            ...history,
-            { role: "user", content: userPrompt },
-        ],
-        max_tokens: maxTokens,
-        stream: false,
-    };
-    // xAI Live Search - pulls real-time results from web/X/news/RSS during inference.
-    // Docs: https://docs.x.ai/docs/guides/live-search
-    // Note: as of late 2026 xAI deprecated this in favor of Agent Tools API
-    // (returns 410 Gone). We detect that and retry without search_parameters
-    // so synthesis still succeeds - just without the real-time augmentation.
-    if (liveSearch) {
-        body.search_parameters = {
-            mode: liveSearch.mode,
-            sources: liveSearch.sources.map((type) => ({ type })),
-            max_search_results: liveSearch.maxResults ?? 10,
-            ...(liveSearch.fromDate ? { from_date: liveSearch.fromDate } : {}),
-            ...(liveSearch.toDate ? { to_date: liveSearch.toDate } : {}),
-        };
-    }
-    let res = await fetch(GROK_URL, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", "Authorization": `Bearer ${apiKey}` },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    // Live Search deprecated → strip search_parameters and retry
-    if (res.status === 410 && liveSearch) {
-        delete body.search_parameters;
-        res = await fetch(GROK_URL, {
-            method: "POST",
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${apiKey}` },
-            body: JSON.stringify(body),
-            signal: AbortSignal.timeout(timeoutMs),
-        });
-    }
-    if (!res.ok) {
-        const errBody = await res.text().catch(() => "");
-        throw new Error(`Grok error ${res.status}: ${errBody.slice(0, 200)}`);
-    }
-    const data = await res.json();
-    const content = data.choices?.[0]?.message?.content ?? "";
-    // When Live Search ran (and was not deprecated), append the citations as a
-    // parsable block at the bottom - downstream consumers (deep_research) can
-    // read these and merge into the final source list.
-    if (liveSearch && data.citations && data.citations.length > 0) {
-        return `${content}\n\n<!--GROK_LIVE_CITATIONS\n${data.citations.join("\n")}\nGROK_LIVE_CITATIONS-->`;
-    }
-    return content;
-}

package/dist/local-memory-file.js

@@ -1,150 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLocalMemoryFileConfig = getLocalMemoryFileConfig;
-exports.fileMemoryAdd = fileMemoryAdd;
-exports.fileMemoryDeleteByVaultKey = fileMemoryDeleteByVaultKey;
-exports.fileMemorySearch = fileMemorySearch;
-exports.fileMemoryList = fileMemoryList;
-exports.fileMemoryDelete = fileMemoryDelete;
-exports.fileMemoryProfile = fileMemoryProfile;
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const crypto = __importStar(require("crypto"));
-const _text_search_js_1 = require("./_text-search.js");
-function getLocalMemoryFileConfig() {
-    return { dir: path.join(os.homedir(), ".finch", "memory") };
-}
-function indexPath(cfg) {
-    return path.join(cfg.dir, "index.json");
-}
-function readIndex(cfg) {
-    try {
-        const raw = fs.readFileSync(indexPath(cfg), "utf8");
-        const parsed = JSON.parse(raw);
-        return { memories: parsed.memories ?? [] };
-    }
-    catch {
-        return { memories: [] };
-    }
-}
-// Atomic write: temp file + rename, matching local-vault.ts's pattern so a
-// crash mid-write can't corrupt the index every memory depends on.
-function writeIndex(cfg, idx) {
-    fs.mkdirSync(cfg.dir, { recursive: true });
-    const tmp = indexPath(cfg) + `.tmp-${process.pid}`;
-    fs.writeFileSync(tmp, JSON.stringify(idx, null, 2), "utf8");
-    fs.renameSync(tmp, indexPath(cfg));
-}
-function toResult(m) {
-    return {
-        id: m.id,
-        content: m.content,
-        metadata: { title: m.title, tags: m.tags, source: m.source, sourceUrl: m.sourceUrl, contentHash: m.contentHash, pinned: m.pinned, addedAt: m.addedAt, vaultKey: m.vaultKey },
-    };
-}
-function fileMemoryAdd(cfg, content, metadata, sourceUrl) {
-    const idx = readIndex(cfg);
-    const id = crypto.randomBytes(8).toString("hex");
-    const row = {
-        id,
-        content,
-        title: metadata.title,
-        tags: metadata.tags,
-        source: metadata.source,
-        sourceUrl,
-        contentHash: metadata.contentHash ?? "",
-        pinned: metadata.pinned,
-        addedAt: metadata.addedAt ?? Date.now(),
-        vaultKey: metadata.vaultKey,
-    };
-    idx.memories.push(row);
-    writeIndex(cfg, idx);
-    return { id };
-}
-/** Remove every memory row mirroring a given vault entry - called by
- * vault_delete so its "PERMANENT... cannot be undone" claim is actually true,
- * instead of leaving the content fully recoverable via memory_search. */
-function fileMemoryDeleteByVaultKey(cfg, vaultKey) {
-    const idx = readIndex(cfg);
-    const next = idx.memories.filter((m) => m.vaultKey !== vaultKey);
-    const removed = idx.memories.length - next.length;
-    if (removed > 0)
-        writeIndex(cfg, { memories: next });
-    return removed;
-}
-function fileMemorySearch(cfg, query, limit) {
-    const idx = readIndex(cfg);
-    const terms = (0, _text_search_js_1.meaningfulTerms)(query);
-    if (terms.length === 0)
-        return [];
-    const scored = [];
-    for (const m of idx.memories) {
-        const hay = `${m.title ?? ""}\n${(m.tags ?? []).join(" ")}\n${m.content}`.toLowerCase();
-        let score = 0;
-        for (const t of terms) {
-            if ((m.title ?? "").toLowerCase().includes(t))
-                score += 3;
-            if ((m.tags ?? []).some((tag) => tag.toLowerCase().includes(t)))
-                score += 2;
-            score += Math.min((0, _text_search_js_1.wordOccurrences)(hay, t), 5);
-        }
-        if (score > 0)
-            scored.push({ m, score });
-    }
-    scored.sort((a, b) => b.score - a.score);
-    const top = scored.slice(0, limit);
-    const maxScore = top[0]?.score || 1;
-    return top.map(({ m, score }) => ({ ...toResult(m), score: score / maxScore }));
-}
-function fileMemoryList(cfg, limit, tag) {
-    const idx = readIndex(cfg);
-    let rows = [...idx.memories].sort((a, b) => b.addedAt - a.addedAt);
-    if (tag)
-        rows = rows.filter((m) => (m.tags ?? []).includes(tag));
-    return rows.slice(0, limit).map(toResult);
-}
-function fileMemoryDelete(cfg, id) {
-    const idx = readIndex(cfg);
-    const next = idx.memories.filter((m) => m.id !== id);
-    if (next.length === idx.memories.length)
-        throw new Error(`Memory not found: ${id}`);
-    writeIndex(cfg, { memories: next });
-}
-function fileMemoryProfile(cfg) {
-    const idx = readIndex(cfg);
-    return { total: idx.memories.length, status: "ok", space: "local" };
-}

package/dist/local-memory.js

@@ -1,135 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLocalMemoryConfig = getLocalMemoryConfig;
-exports.isLocalMemoryReachable = isLocalMemoryReachable;
-exports.localMemoryAdd = localMemoryAdd;
-exports.localMemorySearch = localMemorySearch;
-exports.localMemoryList = localMemoryList;
-exports.localMemoryDelete = localMemoryDelete;
-exports.localMemoryDeleteByVaultKey = localMemoryDeleteByVaultKey;
-exports.localMemoryProfile = localMemoryProfile;
-const config_js_1 = require("./config.js");
-const local_memory_file_js_1 = require("./local-memory-file.js");
-const DEFAULT_URL = "http://localhost:6767";
-const REACHABILITY_TIMEOUT_MS = 1500;
-const CALL_TIMEOUT_MS = 15000;
-// Returns config only when the user has explicitly opted into a local
-// backend. Callers should still treat a null return as "use Convex" - this
-// never throws.
-function getLocalMemoryConfig() {
-    try {
-        const cfg = (0, config_js_1.readConfig)();
-        if (cfg.memoryBackend === "local-file")
-            return { kind: "file", ...(0, local_memory_file_js_1.getLocalMemoryFileConfig)() };
-        if (cfg.memoryBackend === "local" && cfg.supermemoryApiKey) {
-            return { kind: "supermemory", url: cfg.supermemoryUrl ?? DEFAULT_URL, apiKey: cfg.supermemoryApiKey };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-// Requires a genuine 2xx, not just "something answered" - a stale/wrong
-// supermemoryApiKey returns 401 (server is up, but every real memory call
-// will fail the same way), and that must show as unhealthy, not healthy.
-// The file backend is always "reachable" - it's a directory, not a server.
-async function isLocalMemoryReachable(cfg) {
-    if (cfg.kind === "file")
-        return true;
-    try {
-        const res = await fetch(`${cfg.url}/v3/search`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json", Authorization: `Bearer ${cfg.apiKey}` },
-            body: JSON.stringify({ q: "__finch_reachability_check__", limit: 1 }),
-            signal: AbortSignal.timeout(REACHABILITY_TIMEOUT_MS),
-        });
-        return res.ok;
-    }
-    catch {
-        return false;
-    }
-}
-async function localMemoryAdd(cfg, content, metadata, sourceUrl) {
-    if (cfg.kind === "file")
-        return (0, local_memory_file_js_1.fileMemoryAdd)(cfg, content, metadata, sourceUrl);
-    const res = await fetch(`${cfg.url}/v3/documents`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${cfg.apiKey}` },
-        body: JSON.stringify({ content, metadata, ...(sourceUrl ? { sourceUrl } : {}) }),
-        signal: AbortSignal.timeout(CALL_TIMEOUT_MS),
-    });
-    if (!res.ok)
-        throw new Error(`local supermemory add failed: HTTP ${res.status}`);
-    const data = await res.json();
-    return { id: data.id ?? data.documentId ?? "saved" };
-}
-async function localMemorySearch(cfg, query, limit) {
-    if (cfg.kind === "file")
-        return (0, local_memory_file_js_1.fileMemorySearch)(cfg, query, limit);
-    const res = await fetch(`${cfg.url}/v3/search`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${cfg.apiKey}` },
-        body: JSON.stringify({ q: query, limit }),
-        signal: AbortSignal.timeout(CALL_TIMEOUT_MS),
-    });
-    if (!res.ok)
-        throw new Error(`local supermemory search failed: HTTP ${res.status}`);
-    const data = await res.json();
-    return (data.results ?? []).map((r) => ({
-        id: r.id ?? r.documentId ?? "",
-        content: r.content ?? r.chunks?.map((c) => c.content ?? "").join("\n") ?? "",
-        metadata: r.metadata ?? {},
-        score: r.score,
-    }));
-}
-// supermemory's search endpoint doubles as "list": a wildcard query returns
-// recent documents. No dedicated /list endpoint is documented for the local
-// server, so callers pass "*" and post-filter by tag client-side, matching
-// how the Convex-side /memory/list already does its own tag post-filter.
-async function localMemoryList(cfg, limit, tag) {
-    if (cfg.kind === "file")
-        return (0, local_memory_file_js_1.fileMemoryList)(cfg, limit, tag);
-    const rows = await localMemorySearch(cfg, "*", Math.max(limit * (tag ? 3 : 1), limit));
-    const filtered = tag ? rows.filter((r) => Array.isArray(r.metadata?.tags) && r.metadata.tags.includes(tag)) : rows;
-    return filtered.slice(0, limit);
-}
-// Delete endpoint isn't confirmed in the public self-hosting docs at the
-// time this was written - throws a distinct error so callers can surface a
-// clear "not supported locally yet" message instead of a generic failure.
-async function localMemoryDelete(cfg, id) {
-    if (cfg.kind === "file") {
-        (0, local_memory_file_js_1.fileMemoryDelete)(cfg, id);
-        return;
-    }
-    const res = await fetch(`${cfg.url}/v3/documents/${encodeURIComponent(id)}`, {
-        method: "DELETE",
-        headers: { Authorization: `Bearer ${cfg.apiKey}` },
-        signal: AbortSignal.timeout(CALL_TIMEOUT_MS),
-    });
-    if (!res.ok)
-        throw new Error(`local supermemory delete failed: HTTP ${res.status}`);
-}
-/**
- * Remove memory rows mirroring a deleted vault entry - called by vault_delete.
- * "file" backend: direct filter+delete, exact. Self-hosted supermemory server:
- * no documented "delete by metadata filter" endpoint, so this is a no-op that
- * returns 0 rather than guessing at an unconfirmed API - vault_delete surfaces
- * that count so a 0 on that backend doesn't get silently mistaken for success.
- */
-function localMemoryDeleteByVaultKey(cfg, vaultKey) {
-    if (cfg.kind === "file")
-        return (0, local_memory_file_js_1.fileMemoryDeleteByVaultKey)(cfg, vaultKey);
-    return 0;
-}
-// No dedicated count endpoint is documented for the local supermemory server,
-// so that path approximates via a capped wildcard search - accurate up to
-// `PROFILE_SAMPLE_LIMIT`, reported as a floor ("200+") beyond that rather
-// than a false exact count. The file backend counts exactly.
-const PROFILE_SAMPLE_LIMIT = 200;
-async function localMemoryProfile(cfg) {
-    if (cfg.kind === "file")
-        return { ...(0, local_memory_file_js_1.fileMemoryProfile)(cfg), approximate: false };
-    const rows = await localMemorySearch(cfg, "*", PROFILE_SAMPLE_LIMIT);
-    return { total: rows.length, status: "ok", space: "local", approximate: rows.length >= PROFILE_SAMPLE_LIMIT };
-}