@fl0w1nd/search-mcp 0.1.0

package/build/tools/reddit/client.d.ts

@@ -0,0 +1,13 @@
+export declare function formatCompact(data: unknown): string;
+export declare const REDDIT_ACTIONS: string[];
+export declare function executeRedditAction(action: string, params: Record<string, any>): Promise<any>;
+export declare function isRedditUrl(url: string): boolean;
+interface FetchRedditResult {
+    url: string;
+    data?: any;
+    provider?: string;
+    error?: string;
+}
+export declare function fetchRedditUrl(url: string): Promise<FetchRedditResult>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/build/tools/reddit/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/tools/reddit/client.ts"],"names":[],"mappings":"AA2UA,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEnD;AAiBD,eAAO,MAAM,cAAc,UAA8B,CAAC;AAE1D,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,OAAO,CAAC,GAAG,CAAC,CAQd;AAMD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMhD;AAED,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAyC5B"}

package/build/tools/reddit/client.js

@@ -0,0 +1,357 @@
+const REDDIT_BASE_URL = "https://www.reddit.com";
+const USER_AGENT = "SearchMCP-Reddit/1.0.0";
+function getTimeout() {
+    const env = process.env.REDDIT_TIMEOUT;
+    return env ? Number(env) * 1000 : 30_000;
+}
+async function makeRequest(endpoint, params) {
+    const url = new URL(endpoint, REDDIT_BASE_URL);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), getTimeout());
+    try {
+        const res = await fetch(url.toString(), {
+            headers: {
+                "User-Agent": USER_AGENT,
+                Accept: "application/json",
+            },
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            throw new Error(`Reddit API error (${res.status}): ${await res.text()}`);
+        }
+        return res.json();
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// --- Data cleaners (adapted from Jing-yilin/reddit-mcp) ---
+function cleanPost(raw) {
+    if (!raw?.data)
+        return null;
+    const d = raw.data;
+    return {
+        id: d.id,
+        title: d.title,
+        subreddit: d.subreddit,
+        author: d.author,
+        score: d.score,
+        upvoteRatio: d.upvote_ratio,
+        comments: d.num_comments,
+        created: d.created_utc
+            ? new Date(d.created_utc * 1000).toISOString()
+            : null,
+        url: d.url,
+        permalink: `https://reddit.com${d.permalink}`,
+        selftext: d.selftext || undefined,
+        isVideo: d.is_video,
+        isSelf: d.is_self,
+        thumbnail: d.thumbnail !== "self" && d.thumbnail !== "default"
+            ? d.thumbnail
+            : undefined,
+        flair: d.link_flair_text || undefined,
+        awards: d.total_awards_received,
+        over18: d.over_18,
+    };
+}
+function cleanComment(raw, depth = 0) {
+    if (!raw?.data || raw.kind !== "t1")
+        return null;
+    const d = raw.data;
+    const replies = [];
+    if (d.replies?.data?.children) {
+        for (const child of d.replies.data.children) {
+            const cleaned = cleanComment(child, depth + 1);
+            if (cleaned)
+                replies.push(cleaned);
+        }
+    }
+    return {
+        id: d.id,
+        author: d.author,
+        body: d.body,
+        score: d.score,
+        created: d.created_utc
+            ? new Date(d.created_utc * 1000).toISOString()
+            : null,
+        depth,
+        edited: !!d.edited,
+        replies: replies.length > 0 ? replies : undefined,
+    };
+}
+function cleanUser(raw) {
+    if (!raw?.data)
+        return null;
+    const d = raw.data;
+    return {
+        id: d.id,
+        name: d.name,
+        created: d.created_utc
+            ? new Date(d.created_utc * 1000).toISOString()
+            : null,
+        linkKarma: d.link_karma,
+        commentKarma: d.comment_karma,
+        totalKarma: d.total_karma,
+        verified: d.verified,
+        hasVerifiedEmail: d.has_verified_email,
+        premium: d.is_gold,
+        isMod: d.is_mod,
+        iconUrl: d.icon_img?.split("?")[0],
+        description: d.subreddit?.public_description || undefined,
+    };
+}
+function cleanSubreddit(raw) {
+    if (!raw?.data)
+        return null;
+    const d = raw.data;
+    return {
+        id: d.id,
+        name: d.display_name,
+        title: d.title,
+        description: d.public_description,
+        subscribers: d.subscribers,
+        activeUsers: d.accounts_active,
+        created: d.created_utc
+            ? new Date(d.created_utc * 1000).toISOString()
+            : null,
+        over18: d.over18,
+        url: `https://reddit.com${d.url}`,
+        iconUrl: d.icon_img?.split("?")[0] || d.community_icon?.split("?")[0],
+    };
+}
+function cleanPostList(children) {
+    return Array.isArray(children)
+        ? children.map(cleanPost).filter(Boolean)
+        : [];
+}
+function cleanCommentList(children) {
+    return Array.isArray(children)
+        ? children
+            .filter((c) => c.kind === "t1")
+            .map((c) => cleanComment(c, 0))
+            .filter(Boolean)
+        : [];
+}
+// --- Action handlers ---
+async function searchPosts(params) {
+    const query = params.query;
+    if (!query)
+        throw new Error("'query' is required for search_posts");
+    const reqParams = {
+        q: query,
+        sort: params.sort || "relevance",
+        t: params.time || "all",
+        limit: Math.min(params.limit || 10, 100),
+        raw_json: 1,
+        type: "link",
+    };
+    let endpoint = "/search.json";
+    if (params.subreddit) {
+        endpoint = `/r/${params.subreddit}/search.json`;
+        reqParams.restrict_sr = "on";
+    }
+    const data = await makeRequest(endpoint, reqParams);
+    return cleanPostList(data?.data?.children || []);
+}
+async function getSubredditPosts(params) {
+    const subreddit = params.subreddit;
+    if (!subreddit)
+        throw new Error("'subreddit' is required for get_subreddit_posts");
+    const sort = params.sort || "hot";
+    const reqParams = {
+        limit: Math.min(params.limit || 10, 100),
+        raw_json: 1,
+    };
+    if (sort === "top" && params.time)
+        reqParams.t = params.time;
+    const data = await makeRequest(`/r/${subreddit}/${sort}.json`, reqParams);
+    return cleanPostList(data?.data?.children || []);
+}
+async function getPostContent(params) {
+    const postId = params.post_id;
+    if (!postId)
+        throw new Error("'post_id' is required for get_post_content");
+    const reqParams = {
+        limit: params.comment_limit || 20,
+        depth: params.comment_depth || 3,
+        sort: params.sort || "confidence",
+        raw_json: 1,
+    };
+    let endpoint = `/comments/${postId}.json`;
+    if (params.subreddit) {
+        endpoint = `/r/${params.subreddit}/comments/${postId}.json`;
+    }
+    const data = await makeRequest(endpoint, reqParams);
+    const post = cleanPost(data?.[0]?.data?.children?.[0]);
+    const comments = cleanCommentList(data?.[1]?.data?.children || []);
+    return { post, comments };
+}
+async function getUserInfo(params) {
+    const username = params.username;
+    if (!username)
+        throw new Error("'username' is required for get_user_info");
+    const data = await makeRequest(`/user/${username}/about.json`, {
+        raw_json: 1,
+    });
+    return cleanUser(data);
+}
+async function getUserPosts(params) {
+    const username = params.username;
+    if (!username)
+        throw new Error("'username' is required for get_user_posts");
+    const reqParams = {
+        sort: params.sort || "new",
+        limit: Math.min(params.limit || 10, 100),
+        raw_json: 1,
+        type: "links",
+    };
+    if (params.time)
+        reqParams.t = params.time;
+    const data = await makeRequest(`/user/${username}/submitted.json`, reqParams);
+    return cleanPostList(data?.data?.children || []);
+}
+async function getUserComments(params) {
+    const username = params.username;
+    if (!username)
+        throw new Error("'username' is required for get_user_comments");
+    const reqParams = {
+        sort: params.sort || "new",
+        limit: Math.min(params.limit || 10, 100),
+        raw_json: 1,
+        type: "comments",
+    };
+    if (params.time)
+        reqParams.t = params.time;
+    const data = await makeRequest(`/user/${username}/comments.json`, reqParams);
+    const children = data?.data?.children || [];
+    return children
+        .filter((c) => c.kind === "t1" && c.data)
+        .map((c) => {
+        const d = c.data;
+        return {
+            id: d.id,
+            subreddit: d.subreddit,
+            postTitle: d.link_title,
+            author: d.author,
+            body: d.body,
+            score: d.score,
+            created: d.created_utc
+                ? new Date(d.created_utc * 1000).toISOString()
+                : null,
+            permalink: `https://reddit.com${d.permalink}`,
+        };
+    });
+}
+async function getSubredditInfo(params) {
+    const subreddit = params.subreddit;
+    if (!subreddit)
+        throw new Error("'subreddit' is required for get_subreddit_info");
+    const data = await makeRequest(`/r/${subreddit}/about.json`, {
+        raw_json: 1,
+    });
+    return cleanSubreddit(data);
+}
+// --- Compact encoder (token-efficient output, similar to TOON) ---
+function encodeScalar(value) {
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    return String(value);
+}
+function encodeValue(value, depth) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value !== "object")
+        return encodeScalar(value);
+    const pad = "  ".repeat(depth);
+    if (Array.isArray(value)) {
+        const sep = depth > 0 ? `\n${pad}---\n` : "\n---\n";
+        return value
+            .map((item) => encodeValue(item, depth))
+            .filter(Boolean)
+            .join(sep);
+    }
+    const lines = [];
+    for (const [k, v] of Object.entries(value)) {
+        if (v === null || v === undefined)
+            continue;
+        if (typeof v === "object") {
+            lines.push(`${pad}${k}:`);
+            lines.push(encodeValue(v, depth + 1));
+        }
+        else {
+            lines.push(`${pad}${k}:${encodeScalar(v)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatCompact(data) {
+    return encodeValue(data, 0);
+}
+// --- Public API ---
+const actionHandlers = {
+    search_posts: searchPosts,
+    get_subreddit_posts: getSubredditPosts,
+    get_post_content: getPostContent,
+    get_user_info: getUserInfo,
+    get_user_posts: getUserPosts,
+    get_user_comments: getUserComments,
+    get_subreddit_info: getSubredditInfo,
+};
+export const REDDIT_ACTIONS = Object.keys(actionHandlers);
+export async function executeRedditAction(action, params) {
+    const handler = actionHandlers[action];
+    if (!handler) {
+        throw new Error(`Unknown action: "${action}". Available: ${REDDIT_ACTIONS.join(", ")}`);
+    }
+    return handler(params);
+}
+// --- Fetch integration ---
+const REDDIT_HOST_RE = /^(?:www\.|old\.|new\.|np\.)?reddit\.com$/;
+export function isRedditUrl(url) {
+    try {
+        return REDDIT_HOST_RE.test(new URL(url).hostname);
+    }
+    catch {
+        return false;
+    }
+}
+export async function fetchRedditUrl(url) {
+    try {
+        const pathname = new URL(url).pathname.replace(/\/+$/, "");
+        const postMatch = pathname.match(/^\/r\/([^/]+)\/comments\/([^/]+)/);
+        if (postMatch) {
+            const data = await getPostContent({
+                subreddit: postMatch[1],
+                post_id: postMatch[2],
+            });
+            return { url, data, provider: "reddit" };
+        }
+        const subredditMatch = pathname.match(/^\/r\/([^/]+)$/);
+        if (subredditMatch) {
+            const [info, posts] = await Promise.all([
+                getSubredditInfo({ subreddit: subredditMatch[1] }),
+                getSubredditPosts({ subreddit: subredditMatch[1], limit: 10 }),
+            ]);
+            return { url, data: { subreddit: info, hotPosts: posts }, provider: "reddit" };
+        }
+        const userMatch = pathname.match(/^\/(?:user|u)\/([^/]+)/);
+        if (userMatch) {
+            const data = await getUserInfo({ username: userMatch[1] });
+            return { url, data, provider: "reddit" };
+        }
+        // Generic Reddit URL: append .json and return raw
+        const jsonUrl = url.replace(/\/?$/, ".json");
+        const raw = await makeRequest(new URL(jsonUrl).pathname, { raw_json: 1 });
+        return { url, data: raw, provider: "reddit" };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { url, error: `Reddit fetch error: ${message}` };
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/tools/reddit/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/tools/reddit/client.ts"],"names":[],"mappings":"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"}

package/build/tools/reddit/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRedditTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/build/tools/reddit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/reddit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmD3D"}

package/build/tools/reddit/index.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { executeRedditAction, formatCompact } from "./client.js";
+const REDDIT_API_SPEC = `Actions (* = required param):
+- search_posts — Search posts by keyword. query*, subreddit, sort(relevance|hot|top|new|comments), time, limit
+- get_subreddit_posts — Browse subreddit. subreddit*, sort(hot|new|top), time, limit
+- get_post_content — Post with comments. post_id*, subreddit, sort(confidence|top|new|controversial|old|qa), comment_limit, comment_depth
+- get_user_info — User profile. username*
+- get_user_posts — User submissions. username*, sort(hot|new|top|controversial), time, limit
+- get_user_comments — User comments. username*, sort(hot|new|top|controversial), time, limit
+- get_subreddit_info — Subreddit metadata. subreddit*
+time: hour|day|week|month|year|all`;
+export function registerRedditTools(server) {
+    server.tool("social_media_search_help", "Get the API spec for searching and browsing social media in detail. Call this before using search_social_media.", {
+        platform: z
+            .enum(["reddit"])
+            .describe("Target platform"),
+    }, async ({ platform }) => {
+        if (platform === "reddit") {
+            return { content: [{ type: "text", text: REDDIT_API_SPEC }] };
+        }
+        return {
+            content: [{ type: "text", text: `Unsupported platform: "${platform}"` }],
+            isError: true,
+        };
+    });
+    server.tool("search_social_media", "Execute a social media search or data retrieval action. Call social_media_search_help first to get available actions and params for the target platform.", {
+        platform: z.enum(["reddit"]).describe("Target platform"),
+        action: z.string().describe("Action name from social_media_search_help"),
+        params: z
+            .record(z.any())
+            .optional()
+            .describe("Action parameters — see social_media_search_help"),
+    }, async ({ platform, action, params }) => {
+        try {
+            const data = await executeRedditAction(action, (params && typeof params === "object" && !Array.isArray(params))
+                ? params
+                : {});
+            return {
+                content: [{ type: "text", text: formatCompact(data) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/build/tools/reddit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/reddit/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjE,MAAM,eAAe,GAAG;;;;;;;;mCAQW,CAAC;AAEpC,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,iHAAiH,EACjH;QACE,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;aAChB,QAAQ,CAAC,iBAAiB,CAAC;KAC/B,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAuB,EAAE;QAC1C,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,QAAQ,GAAG,EAAE,CAAC;YACxE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,0JAA0J,EAC1J;QACE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACxE,MAAM,EAAE,CAAC;aACN,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;aACf,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;KAChE,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAuB,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CACpC,MAAM,EACN,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9D,CAAC,CAAC,MAA6B;gBAC/B,CAAC,CAAC,EAAE,CACP,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/search/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchTool(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/build/tools/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAY1D"}

package/build/tools/search/index.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { runWithFallback } from "../../core/runner.js";
+import { braveSearch } from "./providers/brave.js";
+import { exaSearch } from "./providers/exa.js";
+const providerMap = {
+    brave: braveSearch,
+    exa: exaSearch,
+};
+const defaultOrder = ["brave", "exa"];
+function getProviders() {
+    const env = process.env.SEARCH_PROVIDERS;
+    const order = env ? env.split(",").map((s) => s.trim()) : defaultOrder;
+    return order.map((name) => providerMap[name]).filter(Boolean);
+}
+export function registerSearchTool(server) {
+    server.tool("search", "Search the web and return relevant results.", {
+        query: z.string().describe("Search query"),
+        maxResults: z.number().int().min(1).max(100).default(10).describe("Number of results to return"),
+    }, async ({ query, maxResults }) => {
+        return runWithFallback(getProviders(), { query, maxResults });
+    });
+}
+//# sourceMappingURL=index.js.map

package/build/tools/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/search/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,GAA6E;IAC5F,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAEtC,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACvE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,6CAA6C,EAC7C;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9B,OAAO,eAAe,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/search/providers/brave.d.ts

@@ -0,0 +1,8 @@
+import { Provider } from "../../../core/provider.js";
+interface SearchInput {
+    query: string;
+    maxResults: number;
+}
+export declare const braveSearch: Provider<SearchInput, unknown>;
+export {};
+//# sourceMappingURL=brave.d.ts.map

package/build/tools/search/providers/brave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.d.ts","sourceRoot":"","sources":["../../../../src/tools/search/providers/brave.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,2BAA2B,CAAC;AAEvE,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AA0BD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CA4BtD,CAAC"}

package/build/tools/search/providers/brave.js

@@ -0,0 +1,47 @@
+import { resolveRateLimit } from "../../../core/provider.js";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+function clean(raw) {
+    const web = (raw.web?.results ?? []).map((r) => ({
+        title: r.title,
+        url: r.url,
+        description: r.description,
+        age: r.age,
+    }));
+    const videos = (raw.videos?.results ?? []).map((r) => ({
+        title: r.title,
+        url: r.url,
+        description: r.description,
+        age: r.age,
+        duration: r.video?.duration,
+    }));
+    return {
+        query: raw.query?.original,
+        web,
+        ...(videos.length > 0 && { videos }),
+    };
+}
+export const braveSearch = {
+    name: "brave",
+    envKey: "BRAVE_API_KEY",
+    rateLimit: resolveRateLimit("BRAVE_SEARCH_RATE_LIMIT", { requests: 1, window: 1000 }),
+    async execute({ query, maxResults }) {
+        const apiKey = process.env.BRAVE_API_KEY;
+        const url = new URL("https://api.search.brave.com/res/v1/web/search");
+        url.searchParams.set("q", query);
+        url.searchParams.set("count", String(Math.min(maxResults, 20)));
+        const res = await fetch(url, {
+            headers: {
+                "Accept": "application/json",
+                "X-Subscription-Token": apiKey,
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`Brave API error: ${res.status} ${await res.text()}`);
+        }
+        return clean(await res.json());
+    },
+    isAvailable() {
+        return !!process.env.BRAVE_API_KEY;
+    },
+};
+//# sourceMappingURL=brave.js.map

package/build/tools/search/providers/brave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.js","sourceRoot":"","sources":["../../../../src/tools/search/providers/brave.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAOvE,uDAAuD;AACvD,SAAS,KAAK,CAAC,GAAQ;IACrB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QACpD,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,GAAG,EAAE,CAAC,CAAC,GAAG;KACX,CAAC,CAAC,CAAC;IAEJ,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QAC1D,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ;KAC5B,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ;QAC1B,GAAG;QACH,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAmC;IACzD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,gBAAgB,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAErF,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAc,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gDAAgD,CAAC,CAAC;QACtE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAEhE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE;gBACP,QAAQ,EAAE,kBAAkB;gBAC5B,sBAAsB,EAAE,MAAM;aAC/B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,WAAW;QACT,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACrC,CAAC;CACF,CAAC"}

package/build/tools/search/providers/exa.d.ts

@@ -0,0 +1,8 @@
+import { Provider } from "../../../core/provider.js";
+interface SearchInput {
+    query: string;
+    maxResults: number;
+}
+export declare const exaSearch: Provider<SearchInput, unknown>;
+export {};
+//# sourceMappingURL=exa.d.ts.map

package/build/tools/search/providers/exa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../../../src/tools/search/providers/exa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,2BAA2B,CAAC;AAEvE,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CA+BpD,CAAC"}

package/build/tools/search/providers/exa.js

@@ -0,0 +1,29 @@
+import { resolveRateLimit } from "../../../core/provider.js";
+export const exaSearch = {
+    name: "exa",
+    envKey: "EXA_API_KEY",
+    rateLimit: resolveRateLimit("EXA_SEARCH_RATE_LIMIT", { requests: 10, window: 1000 }),
+    async execute({ query, maxResults }) {
+        const apiKey = process.env.EXA_API_KEY;
+        const res = await fetch("https://api.exa.ai/search", {
+            method: "POST",
+            headers: {
+                "x-api-key": apiKey,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                query,
+                numResults: Math.min(maxResults, 100),
+                type: "auto",
+            }),
+        });
+        if (!res.ok) {
+            throw new Error(`Exa API error: ${res.status} ${await res.text()}`);
+        }
+        return res.json();
+    },
+    isAvailable() {
+        return !!process.env.EXA_API_KEY;
+    },
+};
+//# sourceMappingURL=exa.js.map

package/build/tools/search/providers/exa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.js","sourceRoot":"","sources":["../../../../src/tools/search/providers/exa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAOvE,MAAM,CAAC,MAAM,SAAS,GAAmC;IACvD,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,gBAAgB,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAEpF,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAY,CAAC;QAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,2BAA2B,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,MAAM;gBACnB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC;gBACrC,IAAI,EAAE,MAAM;aACb,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,WAAW;QACT,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACnC,CAAC;CACF,CAAC"}

package/build/types.d.ts

@@ -0,0 +1,9 @@
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}