opencandle 0.1.1 → 0.3.0

package/dist/providers/reddit.js

@@ -1,56 +1,91 @@
 import { httpGet } from "../infra/http-client.js";
-import { cache, TTL } from "../infra/cache.js";
+import { cache, TTL, STALE_LIMIT } from "../infra/cache.js";
+import { rateLimiter } from "../infra/rate-limiter.js";
+import { BULLISH_TERMS, BEARISH_TERMS } from "../sentiment/keywords.js";
+const REDDIT_HEADERS = { "User-Agent": "OpenCandle/1.0 (financial analysis agent)" };
 export async function getSubredditPosts(subreddit, limit = 25) {
     const cacheKey = `reddit:${subreddit}:${limit}`;
     const cached = cache.get(cacheKey);
     if (cached)
         return cached;
-    const url = `https://www.reddit.com/r/${encodeURIComponent(subreddit)}/hot.json?limit=${limit}`;
+    try {
+        await rateLimiter.acquire("reddit");
+        const url = `https://www.reddit.com/r/${encodeURIComponent(subreddit)}/hot.json?limit=${limit}`;
+        const data = await httpGet(url, {
+            headers: REDDIT_HEADERS,
+        });
+        const posts = data.data.children.map((child) => ({
+            id: child.data.id,
+            title: child.data.title,
+            selftext: child.data.selftext ?? "",
+            author: child.data.author ?? "unknown",
+            score: child.data.score,
+            comments: child.data.num_comments,
+            url: `https://reddit.com${child.data.permalink}`,
+            created: new Date(child.data.created_utc * 1000).toISOString(),
+        }));
+        // Extract ticker-like mentions ($AAPL, $TSLA, etc.)
+        const tickerRegex = /\$([A-Z]{1,5})\b/g;
+        const mentionCounts = new Map();
+        for (const post of posts) {
+            for (const match of post.title.matchAll(tickerRegex)) {
+                const ticker = match[1];
+                mentionCounts.set(ticker, (mentionCounts.get(ticker) ?? 0) + 1);
+            }
+        }
+        const topMentions = [...mentionCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([ticker]) => ticker);
+        const sentiment = scoreSentiment(posts);
+        const result = {
+            subreddit,
+            postCount: posts.length,
+            posts,
+            topMentions,
+            sentimentScore: sentiment.score,
+            bullishCount: sentiment.bullish,
+            bearishCount: sentiment.bearish,
+            fetchedAt: new Date().toISOString(),
+        };
+        cache.set(cacheKey, result, TTL.SENTIMENT);
+        return result;
+    }
+    catch (error) {
+        const stale = cache.getStale(cacheKey, STALE_LIMIT.SENTIMENT);
+        if (stale)
+            return stale.value;
+        throw error;
+    }
+}
+const COMMENT_TTL = 30 * 60 * 1000; // 30 minutes
+export async function getPostComments(subreddit, postId, limit = 5) {
+    const cacheKey = `reddit:comments:${subreddit}:${postId}:${limit}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    await rateLimiter.acquire("reddit_comments");
+    const url = `https://www.reddit.com/r/${encodeURIComponent(subreddit)}/comments/${postId}.json`;
     const data = await httpGet(url, {
-        headers: { "User-Agent": "OpenCandle/1.0 (financial analysis agent)" },
+        headers: REDDIT_HEADERS,
     });
-    const posts = data.data.children.map((child) => ({
-        title: child.data.title,
-        score: child.data.score,
-        comments: child.data.num_comments,
-        url: `https://reddit.com${child.data.permalink}`,
-        created: new Date(child.data.created_utc * 1000).toISOString(),
+    // Comments are in the second listing element
+    const commentListing = data[1]?.data?.children ?? [];
+    const comments = commentListing
+        .filter((c) => c.kind === "t1" && c.data.body)
+        .sort((a, b) => (b.data.score ?? 0) - (a.data.score ?? 0))
+        .slice(0, limit)
+        .map((c) => ({
+        id: c.data.id,
+        body: c.data.body,
+        author: c.data.author ?? "unknown",
+        score: c.data.score ?? 0,
+        permalink: `https://reddit.com${c.data.permalink ?? ""}`,
     }));
-    // Extract ticker-like mentions ($AAPL, $TSLA, etc.)
-    const tickerRegex = /\$([A-Z]{1,5})\b/g;
-    const mentionCounts = new Map();
-    for (const post of posts) {
-        for (const match of post.title.matchAll(tickerRegex)) {
-            const ticker = match[1];
-            mentionCounts.set(ticker, (mentionCounts.get(ticker) ?? 0) + 1);
-        }
-    }
-    const topMentions = [...mentionCounts.entries()]
-        .sort((a, b) => b[1] - a[1])
-        .slice(0, 10)
-        .map(([ticker]) => ticker);
-    const sentiment = scoreSentiment(posts);
-    const result = {
-        subreddit,
-        postCount: posts.length,
-        posts,
-        topMentions,
-        sentimentScore: sentiment.score,
-        bullishCount: sentiment.bullish,
-        bearishCount: sentiment.bearish,
-        fetchedAt: new Date().toISOString(),
-    };
-    cache.set(cacheKey, result, TTL.SENTIMENT);
-    return result;
+    cache.set(cacheKey, comments, COMMENT_TTL);
+    return comments;
 }
-const BULLISH_TERMS = [
-    "moon", "buy", "undervalued", "breakout", "calls", "bullish",
-    "rocket", "diamond hands", "accumulate", "dip buy", "long", "rip", "squeeze",
-];
-const BEARISH_TERMS = [
-    "crash", "overvalued", "sell", "puts", "bearish", "bubble",
-    "dump", "short", "bagholding", "exit", "drill", "tank", "rug",
-];
+// ── Sentiment scoring ───────────────────────────────────
 export function scoreSentiment(posts) {
     let bullish = 0;
     let bearish = 0;

package/dist/providers/reddit.js.map

@@ -1 +1 @@
-{"version":3,"file":"reddit.js","sourceRoot":"","sources":["../../src/providers/reddit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reddit.js","sourceRoot":"","sources":["../../src/providers/reddit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAmBxE,MAAM,cAAc,GAAG,EAAE,YAAY,EAAE,2CAA2C,EAAE,CAAC;AAErF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,QAAgB,EAAE;IAElB,MAAM,QAAQ,GAAG,UAAU,SAAS,IAAI,KAAK,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAwB,QAAQ,CAAC,CAAC;IAC1D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,4BAA4B,kBAAkB,CAAC,SAAS,CAAC,mBAAmB,KAAK,EAAE,CAAC;QAChG,MAAM,IAAI,GAAG,MAAM,OAAO,CAAwB,GAAG,EAAE;YACrD,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACjB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;YACvB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE;YACnC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,SAAS;YACtC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;YACvB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY;YACjC,GAAG,EAAE,qBAAqB,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;YAChD,OAAO,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;SAC/D,CAAC,CAAC,CAAC;QAEJ,oDAAoD;QACpD,MAAM,WAAW,GAAG,mBAAmB,CAAC;QACxC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACxB,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;aAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAExC,MAAM,MAAM,GAA0B;YACpC,SAAS;YACT,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,KAAK;YACL,WAAW;YACX,cAAc,EAAE,SAAS,CAAC,KAAK;YAC/B,YAAY,EAAE,SAAS,CAAC,OAAO;YAC/B,YAAY,EAAE,SAAS,CAAC,OAAO;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAwB,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;QACrF,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAYD,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAEjD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,MAAc,EACd,QAAgB,CAAC;IAEjB,MAAM,QAAQ,GAAG,mBAAmB,SAAS,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAkB,QAAQ,CAAC,CAAC;IACpD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,4BAA4B,kBAAkB,CAAC,SAAS,CAAC,aAAa,MAAM,OAAO,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,OAAO,CAAmJ,GAAG,EAAE;QAChL,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,6CAA6C;IAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAoB,cAAc;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;SACzD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE;QACb,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAK;QAClB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,SAAS;QAClC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;QACxB,SAAS,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE;KACzD,CAAC,CAAC,CAAC;IAEN,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2DAA2D;AAE3D,MAAM,UAAU,cAAc,CAC5B,KAA+B;IAE/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjE,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAChC,OAAO;QACL,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,KAAK;QACpD,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/providers/twitter.d.ts

@@ -0,0 +1,20 @@
+import type { TwitterSentimentResult } from "../types/sentiment.js";
+interface FirefoxCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+}
+export declare function readTwitterCookies(profileDir: string): FirefoxCookie[];
+export declare function scoreTwitterSentiment(tweets: Array<{
+    text: string;
+    likes: number;
+    retweets: number;
+}>): {
+    score: number;
+    bullish: number;
+    bearish: number;
+};
+export declare function normalizeQuery(query: string): string;
+export declare function getTwitterSentiment(query: string, limit?: number, hours?: number): Promise<TwitterSentimentResult>;
+export {};

package/dist/providers/twitter.js

@@ -0,0 +1,137 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import Database from "better-sqlite3";
+import { Scraper, SearchMode } from "@the-convocation/twitter-scraper";
+import { cache, TTL, STALE_LIMIT } from "../infra/cache.js";
+import { rateLimiter } from "../infra/rate-limiter.js";
+import { getBrowserProfileDir } from "../infra/opencandle-paths.js";
+export function readTwitterCookies(profileDir) {
+    const dbPath = join(profileDir, "cookies.sqlite");
+    if (!existsSync(dbPath))
+        return [];
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        const rows = db
+            .prepare(`SELECT name, value, host AS domain, path FROM moz_cookies WHERE host LIKE ? OR host LIKE ?`)
+            .all("%x.com%", "%twitter.com%");
+        return rows;
+    }
+    finally {
+        db.close();
+    }
+}
+// ── Sentiment scoring ────────────────────────────────────
+import { BULLISH_TERMS, BEARISH_TERMS } from "../sentiment/keywords.js";
+export function scoreTwitterSentiment(tweets) {
+    let bullishWeight = 0;
+    let bearishWeight = 0;
+    let bullishCount = 0;
+    let bearishCount = 0;
+    for (const tweet of tweets) {
+        const lower = tweet.text.toLowerCase();
+        const engagement = 1 + (tweet.likes ?? 0) + (tweet.retweets ?? 0);
+        const tweetBullish = BULLISH_TERMS.filter((t) => lower.includes(t)).length;
+        const tweetBearish = BEARISH_TERMS.filter((t) => lower.includes(t)).length;
+        bullishCount += tweetBullish;
+        bearishCount += tweetBearish;
+        bullishWeight += tweetBullish * engagement;
+        bearishWeight += tweetBearish * engagement;
+    }
+    const totalWeight = bullishWeight + bearishWeight;
+    return {
+        score: totalWeight === 0 ? 0 : (bullishWeight - bearishWeight) / totalWeight,
+        bullish: bullishCount,
+        bearish: bearishCount,
+    };
+}
+// ── Query normalization ──────────────────────────────────
+export function normalizeQuery(query) {
+    if (/^[A-Z]{1,5}$/.test(query))
+        return "$" + query;
+    return query;
+}
+// ── Main provider function ───────────────────────────────
+export async function getTwitterSentiment(query, limit = 50, hours = 24) {
+    const normalizedQuery = normalizeQuery(query);
+    const cacheKey = `twitter:${normalizedQuery}:${limit}:${hours}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    await rateLimiter.acquire("twitter");
+    try {
+        const profileDir = getBrowserProfileDir();
+        const cookies = readTwitterCookies(profileDir);
+        const authToken = cookies.find((c) => c.name === "auth_token");
+        const ct0 = cookies.find((c) => c.name === "ct0");
+        if (!authToken || !ct0) {
+            throw new Error("No Twitter session found.");
+        }
+        const scraper = new Scraper();
+        const cookieStrings = cookies.map((c) => `${c.name}=${c.value}; Domain=${c.domain}; Path=${c.path}`);
+        await scraper.setCookies(cookieStrings);
+        const loggedIn = await scraper.isLoggedIn();
+        if (!loggedIn) {
+            throw new Error("Twitter session expired.");
+        }
+        const cutoff = new Date(Date.now() - hours * 3_600_000);
+        const tweets = [];
+        const results = scraper.searchTweets(normalizedQuery, limit, SearchMode.Latest);
+        for await (const tweet of results) {
+            const created = tweet.timeParsed ?? new Date(0);
+            if (created < cutoff)
+                continue;
+            tweets.push({
+                id: tweet.id ?? "",
+                text: tweet.text?.slice(0, 280) ?? "",
+                author: tweet.username ?? "unknown",
+                likes: tweet.likes ?? 0,
+                retweets: tweet.retweets ?? 0,
+                replies: tweet.replies ?? 0,
+                views: tweet.views ?? null,
+                url: tweet.permanentUrl ?? "",
+                created: created.toISOString(),
+            });
+            if (tweets.length >= limit)
+                break;
+        }
+        // Extract co-mentioned cashtags
+        const tickerRegex = /\$([A-Z]{1,5})\b/g;
+        const mentionCounts = new Map();
+        // Exclude the searched ticker itself from co-mentions
+        const searchedTicker = normalizedQuery.startsWith("$")
+            ? normalizedQuery.slice(1)
+            : null;
+        for (const t of tweets) {
+            for (const match of t.text.matchAll(tickerRegex)) {
+                const ticker = match[1];
+                if (ticker === searchedTicker)
+                    continue;
+                mentionCounts.set(ticker, (mentionCounts.get(ticker) ?? 0) + 1);
+            }
+        }
+        const topMentions = [...mentionCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([ticker]) => ticker);
+        const sentiment = scoreTwitterSentiment(tweets);
+        const result = {
+            query: normalizedQuery,
+            tweetCount: tweets.length,
+            tweets,
+            sentimentScore: sentiment.score,
+            bullishCount: sentiment.bullish,
+            bearishCount: sentiment.bearish,
+            topMentions,
+            fetchedAt: new Date().toISOString(),
+        };
+        cache.set(cacheKey, result, TTL.SENTIMENT);
+        return result;
+    }
+    catch (error) {
+        const stale = cache.getStale(cacheKey, STALE_LIMIT.SENTIMENT);
+        if (stale)
+            return stale.value;
+        throw error;
+    }
+}
+//# sourceMappingURL=twitter.js.map

package/dist/providers/twitter.js.map

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

package/dist/providers/web-search.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderResult } from "../runtime/evidence.js";
+import type { WebSearchEnvelope } from "../types/sentiment.js";
+export interface WebSearchOpts {
+    category: "news" | "general";
+    freshness: "hours" | "day" | "week" | "month";
+    limit: number;
+    /** Override provider: skip cascade, use this provider only. */
+    provider?: "exa" | "brave" | "ddg";
+}
+/**
+ * Normalize queries for financial context.
+ * Only applied when category is "news" — general queries pass through unchanged.
+ */
+export declare function normalizeFinancialQuery(query: string, category: "news" | "general"): string;
+export declare function ddgSearch(query: string, opts: WebSearchOpts): Promise<WebSearchEnvelope>;
+export declare function braveSearch(query: string, opts: WebSearchOpts, apiKey: string): Promise<WebSearchEnvelope>;
+export declare function searchWeb(query: string, opts?: Partial<WebSearchOpts>): Promise<ProviderResult<WebSearchEnvelope>>;

package/dist/providers/web-search.js

@@ -0,0 +1,224 @@
+import { search, searchNews, SafeSearchType, SearchTimeType } from "duck-duck-scrape";
+import { httpGet, HttpError } from "../infra/http-client.js";
+import { cache, TTL, STALE_LIMIT } from "../infra/cache.js";
+import { rateLimiter } from "../infra/rate-limiter.js";
+import { getConfig } from "../config.js";
+import { withFallback } from "./with-fallback.js";
+import { exaSearch } from "./exa-search.js";
+import { ProviderCredentialError } from "./provider-credential-error.js";
+const BARE_TICKER = /^[A-Z]{1,5}$/;
+const CASHTAG = /^\$[A-Z]{1,5}$/;
+/**
+ * Normalize queries for financial context.
+ * Only applied when category is "news" — general queries pass through unchanged.
+ */
+export function normalizeFinancialQuery(query, category) {
+    if (category !== "news")
+        return query;
+    if (CASHTAG.test(query))
+        return `${query.slice(1)} stock news`;
+    if (BARE_TICKER.test(query))
+        return `${query} stock news`;
+    return query;
+}
+function stripHtmlTags(text) {
+    return text.replace(/<[^>]*>/g, "");
+}
+function mapFreshness(freshness) {
+    switch (freshness) {
+        case "hours":
+            return SearchTimeType.DAY; // closest available
+        case "day":
+            return SearchTimeType.DAY;
+        case "week":
+            return SearchTimeType.WEEK;
+        case "month":
+            return SearchTimeType.MONTH;
+    }
+}
+function extractDomain(url) {
+    try {
+        const hostname = new URL(url).hostname;
+        return hostname.replace(/^www\./, "");
+    }
+    catch {
+        return url;
+    }
+}
+function mapGeneralResult(r) {
+    return {
+        title: r.title,
+        url: r.url,
+        snippet: stripHtmlTags(r.description),
+        source: r.hostname || extractDomain(r.url),
+        published: null,
+        category: "general",
+    };
+}
+function mapNewsResult(r) {
+    return {
+        title: r.title,
+        url: r.url,
+        snippet: r.excerpt,
+        source: r.syndicate || extractDomain(r.url),
+        published: r.date ? new Date(r.date * 1000).toISOString() : null,
+        category: "news",
+    };
+}
+function ddgCacheKey(query, opts) {
+    return `web:ddg:${query}:${opts.category}:${opts.freshness}:${opts.limit}`;
+}
+export async function ddgSearch(query, opts) {
+    const key = ddgCacheKey(query, opts);
+    const cached = cache.get(key);
+    if (cached)
+        return cached;
+    try {
+        await rateLimiter.acquire("ddg");
+        let results;
+        if (opts.category === "news") {
+            const response = await searchNews(query, { time: mapFreshness(opts.freshness), safeSearch: SafeSearchType.STRICT }, undefined);
+            results = (response.results || []).slice(0, opts.limit).map(mapNewsResult);
+        }
+        else {
+            const response = await search(query, { time: mapFreshness(opts.freshness), safeSearch: SafeSearchType.STRICT }, undefined);
+            results = (response.results || []).slice(0, opts.limit).map(mapGeneralResult);
+        }
+        const envelope = {
+            query,
+            results,
+            resultCount: results.length,
+            fetchedAt: new Date().toISOString(),
+            provider: "ddg",
+        };
+        cache.set(key, envelope, TTL.WEB_SEARCH);
+        return envelope;
+    }
+    catch (error) {
+        const stale = cache.getStale(key, STALE_LIMIT.WEB_SEARCH);
+        if (stale)
+            return stale.value;
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// Brave Search
+// ---------------------------------------------------------------------------
+const BRAVE_BASE = "https://api.search.brave.com/res/v1";
+function mapBraveFreshness(freshness) {
+    switch (freshness) {
+        case "hours": return "ph";
+        case "day": return "pd";
+        case "week": return "pw";
+        case "month": return "pm";
+    }
+}
+function mapBraveNewsResult(r) {
+    return {
+        title: r.title,
+        url: r.url,
+        snippet: r.description,
+        source: r.source || r.meta_url?.hostname || extractDomain(r.url),
+        published: null, // Brave news returns relative "age" not absolute timestamps
+        category: "news",
+    };
+}
+function mapBraveWebResult(r) {
+    return {
+        title: r.title,
+        url: r.url,
+        snippet: r.description,
+        source: r.meta_url?.hostname || extractDomain(r.url),
+        published: null,
+        category: "general",
+    };
+}
+function braveCacheKey(query, opts) {
+    return `web:brave:${query}:${opts.category}:${opts.freshness}:${opts.limit}`;
+}
+export async function braveSearch(query, opts, apiKey) {
+    const key = braveCacheKey(query, opts);
+    const cached = cache.get(key);
+    if (cached)
+        return cached;
+    try {
+        await rateLimiter.acquire("brave_search");
+        const endpoint = opts.category === "news" ? "news/search" : "web/search";
+        const freshness = mapBraveFreshness(opts.freshness);
+        const url = `${BRAVE_BASE}/${endpoint}?q=${encodeURIComponent(query)}&count=${opts.limit}&freshness=${freshness}`;
+        const data = await httpGet(url, {
+            headers: {
+                "X-Subscription-Token": apiKey,
+                Accept: "application/json",
+            },
+        });
+        let results;
+        if (opts.category === "news") {
+            const newsResults = (data.results || []);
+            results = newsResults.slice(0, opts.limit).map(mapBraveNewsResult);
+        }
+        else {
+            const webResults = (data.web?.results || []);
+            results = webResults.slice(0, opts.limit).map(mapBraveWebResult);
+        }
+        const envelope = {
+            query,
+            results,
+            resultCount: results.length,
+            fetchedAt: new Date().toISOString(),
+            provider: "brave",
+        };
+        cache.set(key, envelope, TTL.WEB_SEARCH);
+        return envelope;
+    }
+    catch (error) {
+        const status = error instanceof HttpError ? error.status : error?.statusCode;
+        if (status === 401 || status === 403) {
+            throw new ProviderCredentialError("brave", "stale", status);
+        }
+        const stale = cache.getStale(key, STALE_LIMIT.WEB_SEARCH);
+        if (stale)
+            return stale.value;
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// Cascade orchestrator
+// ---------------------------------------------------------------------------
+const DEFAULT_OPTS = {
+    category: "news",
+    freshness: "day",
+    limit: 10,
+};
+export async function searchWeb(query, opts) {
+    const resolved = { ...DEFAULT_OPTS, ...opts };
+    const normalized = normalizeFinancialQuery(query, resolved.category);
+    const config = getConfig();
+    const entries = [];
+    // Provider override: skip cascade, use only the specified provider
+    if (resolved.provider) {
+        switch (resolved.provider) {
+            case "exa":
+                entries.push({ provider: "exa", fn: () => exaSearch(normalized, resolved) });
+                break;
+            case "brave":
+                if (!config.braveApiKey) {
+                    return { status: "unavailable", reason: "BRAVE_API_KEY not configured", provider: "brave_search" };
+                }
+                entries.push({ provider: "brave_search", fn: () => braveSearch(normalized, resolved, config.braveApiKey) });
+                break;
+            case "ddg":
+                entries.push({ provider: "ddg", fn: () => ddgSearch(normalized, resolved) });
+                break;
+        }
+        return withFallback(entries);
+    }
+    // Default cascade: Exa → Brave → DDG
+    entries.push({ provider: "exa", fn: () => exaSearch(normalized, resolved) });
+    if (config.braveApiKey) {
+        entries.push({ provider: "brave_search", fn: () => braveSearch(normalized, resolved, config.braveApiKey) });
+    }
+    entries.push({ provider: "ddg", fn: () => ddgSearch(normalized, resolved) });
+    return withFallback(entries);
+}
+//# sourceMappingURL=web-search.js.map

package/dist/providers/web-search.js.map

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

package/dist/providers/with-fallback.d.ts

@@ -0,0 +1,15 @@
+import type { ProviderResult } from "../runtime/evidence.js";
+export interface FallbackEntry<T> {
+    provider: string;
+    fn: () => Promise<T>;
+}
+/**
+ * Try providers in order, stopping at the first success.
+ * Skips circuit-open providers. Each provider call goes through wrapProvider
+ * (circuit check + failure recording + stale flag propagation).
+ *
+ * Stale cache fallback is NOT managed here — it happens inside each
+ * provider function (Level B). By the time a provider throws to wrapProvider,
+ * it already tried its own stale cache.
+ */
+export declare function withFallback<T>(entries: FallbackEntry<T>[]): Promise<ProviderResult<T>>;

package/dist/providers/with-fallback.js

@@ -0,0 +1,32 @@
+import { wrapProvider } from "./wrap-provider.js";
+import { getProviderTracker } from "../runtime/run-context.js";
+/**
+ * Try providers in order, stopping at the first success.
+ * Skips circuit-open providers. Each provider call goes through wrapProvider
+ * (circuit check + failure recording + stale flag propagation).
+ *
+ * Stale cache fallback is NOT managed here — it happens inside each
+ * provider function (Level B). By the time a provider throws to wrapProvider,
+ * it already tried its own stale cache.
+ */
+export async function withFallback(entries) {
+    const tracker = getProviderTracker();
+    const attempted = [];
+    for (const entry of entries) {
+        if (tracker?.isCircuitOpen(entry.provider))
+            continue;
+        attempted.push(entry.provider);
+        const result = await wrapProvider(entry.provider, entry.fn);
+        if (result.status === "ok")
+            return result;
+        // wrapProvider already called recordFailure on the tracker
+    }
+    return {
+        status: "unavailable",
+        reason: attempted.length > 0
+            ? `all providers failed: ${attempted.join(", ")}`
+            : `all providers circuit-open: ${entries.map((e) => e.provider).join(", ")}`,
+        provider: entries[0]?.provider ?? "unknown",
+    };
+}
+//# sourceMappingURL=with-fallback.js.map

package/dist/providers/with-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-fallback.js","sourceRoot":"","sources":["../../src/providers/with-fallback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAO/D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA2B;IAE3B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,SAAS;QACrD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC1C,2DAA2D;IAC7D,CAAC;IAED,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,yBAAyB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACjD,CAAC,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC9E,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,SAAS;KAC5C,CAAC;AACJ,CAAC"}