opencandle 0.1.1 → 0.3.0

package/dist/tools/sentiment/sentiment-summary.js

@@ -0,0 +1,230 @@
+import { Type } from "@sinclair/typebox";
+import { getSubredditPosts, getPostComments } from "../../providers/reddit.js";
+import { getTwitterSentiment } from "../../providers/twitter.js";
+import { searchWeb } from "../../providers/web-search.js";
+import { getCompanyNews, finnhubDateRange } from "../../providers/finnhub.js";
+import { wrapProvider } from "../../providers/wrap-provider.js";
+import { getConfig } from "../../config.js";
+import { TwitterAdapter } from "../../sentiment/adapters/twitter.js";
+import { RedditAdapter } from "../../sentiment/adapters/reddit.js";
+import { WebAdapter } from "../../sentiment/adapters/web.js";
+import { FinnhubAdapter, extractTickersFromQuery } from "../../sentiment/adapters/finnhub.js";
+import { getSentimentPipeline } from "../../sentiment/index.js";
+import { hasCredential } from "../../onboarding/providers.js";
+import { buildSoftDegradedTag } from "../../onboarding/tool-tags.js";
+const params = Type.Object({
+    query: Type.String({ description: "Ticker or topic for cross-source sentiment summary" }),
+    hours: Type.Optional(Type.Number({ description: "Lookback window in hours for live fetching. Default: 24" })),
+});
+export const sentimentSummaryTool = {
+    name: "get_sentiment_summary",
+    label: "Sentiment Summary",
+    description: "Cross-source sentiment summary combining Twitter, Reddit, and web/news. Returns per-source scores, aggregate sentiment, and divergence detection.",
+    parameters: params,
+    async execute(toolCallId, args) {
+        const hours = args.hours ?? 24;
+        const config = getConfig();
+        const warnings = [];
+        const allRecords = [];
+        const twitterAdapter = new TwitterAdapter();
+        const redditAdapter = new RedditAdapter();
+        const webAdapter = new WebAdapter();
+        const finnhubAdapter = new FinnhubAdapter();
+        // Determine if Finnhub should be included (key configured + ticker in
+        // query). `candidateTickers` is extracted unconditionally so we can tell
+        // a "no finnhub-mappable ticker in the query" case apart from a "query
+        // has tickers but user has no Finnhub key" case — the latter warrants a
+        // soft-degraded tag so the LLM surfaces it in the Data gaps section.
+        const candidateTickers = extractTickersFromQuery(args.query);
+        const finnhubTickers = config.finnhubApiKey ? candidateTickers : [];
+        const includeFinnhub = finnhubTickers.length > 0 && Boolean(config.finnhubApiKey);
+        const finnhubSoftDegraded = candidateTickers.length > 0 && !hasCredential("finnhub");
+        // Finnhub fetch (built separately to avoid mixing promise types in allSettled)
+        const finnhubFetch = includeFinnhub
+            ? (async () => {
+                const { from, to } = finnhubDateRange("day");
+                const arrays = await Promise.all(finnhubTickers.map((sym) => getCompanyNews(sym, from, to, config.finnhubApiKey)));
+                return arrays.flat();
+            })()
+            : Promise.resolve([]);
+        // Fetch all sources in parallel
+        const [twitterResult, redditResults, webResult, finnhubResult] = await Promise.allSettled([
+            // Twitter
+            wrapProvider("twitter", () => getTwitterSentiment(args.query, 50, hours)),
+            // Reddit — cross-subreddit
+            fetchRedditCrossSubreddit(args.query, config.sentiment?.defaultSubreddits ?? ["wallstreetbets", "stocks", "investing", "options"]),
+            // Web
+            searchWeb(args.query, { freshness: "day", limit: 10, category: "news" }),
+            // Finnhub — only when includeFinnhub; otherwise resolves to []
+            finnhubFetch,
+        ]);
+        // Process Twitter
+        if (twitterResult.status === "fulfilled" && twitterResult.value.status === "ok") {
+            const records = twitterAdapter.mapToRecords(twitterResult.value.data, args.query);
+            allRecords.push(...records);
+        }
+        else {
+            const reason = twitterResult.status === "rejected"
+                ? twitterResult.reason?.message ?? "unknown error"
+                : twitterResult.value.reason ?? "unavailable";
+            warnings.push(`Twitter: ${reason}`);
+        }
+        // Process Reddit
+        if (redditResults.status === "fulfilled") {
+            const { records: redditRecords, warnings: redditWarnings } = redditResults.value;
+            allRecords.push(...redditRecords);
+            warnings.push(...redditWarnings);
+        }
+        else {
+            warnings.push(`Reddit: ${redditResults.reason?.message ?? "unknown error"}`);
+        }
+        // Process Web
+        if (webResult.status === "fulfilled" && webResult.value.status === "ok") {
+            const records = webAdapter.mapToRecords(webResult.value.data, args.query);
+            allRecords.push(...records);
+        }
+        else {
+            const reason = webResult.status === "rejected"
+                ? webResult.reason?.message ?? "unknown error"
+                : webResult.value.reason ?? "unavailable";
+            warnings.push(`Web: ${reason}`);
+        }
+        // Process Finnhub (only when included — otherwise resolves to empty array anyway)
+        if (includeFinnhub) {
+            if (finnhubResult.status === "fulfilled") {
+                const articles = finnhubResult.value;
+                if (articles.length > 0) {
+                    const records = finnhubAdapter.mapToRecords(articles, args.query);
+                    allRecords.push(...records);
+                }
+            }
+            else {
+                warnings.push(`Finnhub: ${finnhubResult.reason?.message ?? "unknown error"}`);
+            }
+        }
+        const softDegradedPrefix = finnhubSoftDegraded
+            ? `${buildSoftDegradedTag({
+                provider: "finnhub",
+                fallback: "other-sentiment-sources",
+                remediation: "run /connect news to enable Finnhub company news",
+            })}\n\n`
+            : "";
+        if (allRecords.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${softDegradedPrefix}⚠ Sentiment summary unavailable for "${args.query}" — no sources returned data.\n${warnings.join("\n")}`,
+                    },
+                ],
+                details: null,
+            };
+        }
+        // Score and index through pipeline
+        const pipeline = getSentimentPipeline();
+        const result = await pipeline.processRecords(allRecords, args.query);
+        // Group by source (exclude comments from per-source averages)
+        const bySource = {};
+        for (const rec of result.fresh) {
+            if (rec.metadata.isComment)
+                continue;
+            if (!bySource[rec.source])
+                bySource[rec.source] = { total: 0, count: 0 };
+            bySource[rec.source].total += rec.sentiment.score;
+            bySource[rec.source].count++;
+        }
+        const lines = [];
+        lines.push(`**Sentiment summary for "${args.query}"** (last ${hours}h):`);
+        lines.push("");
+        lines.push("| Source | Score | Count | Signal |");
+        lines.push("|--------|-------|-------|--------|");
+        let totalScore = 0;
+        let totalCount = 0;
+        for (const [source, stats] of Object.entries(bySource)) {
+            const avg = stats.count > 0 ? stats.total / stats.count : 0;
+            const label = sentimentLabel(avg);
+            const sourceName = source === "web" ? "Web/News" : source.charAt(0).toUpperCase() + source.slice(1);
+            lines.push(`| ${sourceName} | ${avg >= 0 ? "+" : ""}${avg.toFixed(2)} | ${stats.count} | ${label} |`);
+            totalScore += stats.total;
+            totalCount += stats.count;
+        }
+        const aggregate = totalCount > 0 ? totalScore / totalCount : 0;
+        lines.push("");
+        lines.push(`**Aggregate:** ${aggregate >= 0 ? "+" : ""}${aggregate.toFixed(2)} (${sentimentLabel(aggregate)})`);
+        // Divergence
+        if (result.divergence && result.divergence.detected) {
+            lines.push("");
+            lines.push(result.divergence.message);
+        }
+        else if (result.divergence && !result.divergence.detected) {
+            lines.push("");
+            lines.push(result.divergence.message);
+        }
+        // Trend
+        if (result.trend && result.trend.length > 0) {
+            const t = result.trend[0];
+            lines.push("");
+            lines.push(`Trend: ${t.sparkline} ${t.direction} (${t.count} records)`);
+        }
+        if (warnings.length > 0) {
+            lines.push("");
+            lines.push(warnings.map((w) => `⚠ ${w}`).join("\n"));
+        }
+        const output = softDegradedPrefix + lines.join("\n");
+        return { content: [{ type: "text", text: output }], details: result };
+    },
+};
+async function fetchRedditCrossSubreddit(query, subreddits) {
+    const adapter = new RedditAdapter();
+    const records = [];
+    const warnings = [];
+    const config = getConfig();
+    const commentsPerPost = config.sentiment?.commentsPerPost ?? 5;
+    for (const sub of subreddits) {
+        const result = await wrapProvider("reddit", () => getSubredditPosts(sub, 25));
+        if (result.status === "unavailable") {
+            warnings.push(`Reddit r/${sub}: ${result.reason}`);
+            continue;
+        }
+        const postRecords = adapter.mapPostsToRecords(result.data, query);
+        // Topic filter
+        const queryLower = query.toLowerCase();
+        const filtered = postRecords.filter((r) => r.text.toLowerCase().includes(queryLower) ||
+            (r.title?.toLowerCase().includes(queryLower) ?? false));
+        records.push(...filtered);
+        // Fetch comments for top posts
+        const topPosts = [...filtered]
+            .sort((a, b) => b.engagement.score - a.engagement.score)
+            .slice(0, 3); // fewer per sub since we're searching multiple
+        for (const post of topPosts) {
+            if ((post.engagement.replies ?? 0) === 0)
+                continue;
+            try {
+                const comments = await getPostComments(sub, post.sourceId, commentsPerPost);
+                records.push(...adapter.mapCommentsToRecords(comments, post.sourceId, sub, query));
+            }
+            catch { /* non-fatal */ }
+        }
+    }
+    // Deduplicate
+    const seen = new Set();
+    const deduped = records.filter((r) => {
+        if (seen.has(r.sourceId))
+            return false;
+        seen.add(r.sourceId);
+        return true;
+    });
+    return { records: deduped, warnings };
+}
+function sentimentLabel(score) {
+    if (score > 0.3)
+        return "Bullish";
+    if (score < -0.3)
+        return "Bearish";
+    if (score > 0)
+        return "Leaning Bullish";
+    if (score < 0)
+        return "Leaning Bearish";
+    return "Neutral";
+}
+//# sourceMappingURL=sentiment-summary.js.map

package/dist/tools/sentiment/sentiment-summary.js.map

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

package/dist/tools/sentiment/sentiment-trend.d.ts

@@ -0,0 +1,22 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { SentimentStore } from "../../sentiment/store.js";
+declare const params: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    days: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"twitter">, import("@sinclair/typebox").TLiteral<"reddit">, import("@sinclair/typebox").TLiteral<"web">, import("@sinclair/typebox").TLiteral<"finnhub">]>>;
+}>;
+interface TrendToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: any;
+}
+export declare const sentimentTrendTool: AgentTool<typeof params> & {
+    executeWithStore: (toolCallId: string, args: {
+        query: string;
+        days?: number;
+        source?: string;
+    }, store: SentimentStore) => Promise<TrendToolResult>;
+};
+export {};

package/dist/tools/sentiment/sentiment-trend.js

@@ -0,0 +1,39 @@
+import { Type } from "@sinclair/typebox";
+import { getSentimentStore } from "../../sentiment/index.js";
+import { computeTrend } from "../../sentiment/trends.js";
+const params = Type.Object({
+    query: Type.String({ description: "Ticker or topic to look up sentiment history" }),
+    days: Type.Optional(Type.Number({ description: "Number of days of history. Default: 7, max: 30" })),
+    source: Type.Optional(Type.Union([Type.Literal("twitter"), Type.Literal("reddit"), Type.Literal("web"), Type.Literal("finnhub")], {
+        description: "Filter to a single source. Default: all sources.",
+    })),
+});
+export const sentimentTrendTool = {
+    name: "get_sentiment_trend",
+    label: "Sentiment Trend",
+    description: "Query historical sentiment data from the local store. No live API calls — returns trends from previously fetched data. Run a sentiment query first to populate the store.",
+    parameters: params,
+    async execute(toolCallId, args) {
+        const store = getSentimentStore();
+        return sentimentTrendTool.executeWithStore(toolCallId, args, store);
+    },
+    async executeWithStore(_toolCallId, args, store) {
+        const days = Math.min(args.days ?? 7, 30);
+        const series = store.getTimeSeries(args.query, { days, bucketHours: 24 });
+        if (series.length === 0) {
+            return {
+                content: [{ type: "text", text: `No historical sentiment data for "${args.query}". Run a sentiment query first to populate the store.` }],
+                details: null,
+            };
+        }
+        const trend = computeTrend(series, args.source ?? "aggregate");
+        const lines = [
+            `**Sentiment trend for "${args.query}"** (${days}d):`,
+            "",
+            `${trend.sparkline}  ${trend.direction} (${trend.delta >= 0 ? "+" : ""}${trend.delta.toFixed(2)})`,
+            `Avg: ${trend.avgScore.toFixed(2)} | Records: ${trend.count}`,
+        ];
+        return { content: [{ type: "text", text: lines.join("\n") }], details: { trend, series } };
+    },
+};
+//# sourceMappingURL=sentiment-trend.js.map

package/dist/tools/sentiment/sentiment-trend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentiment-trend.js","sourceRoot":"","sources":["../../../src/tools/sentiment/sentiment-trend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;IACnF,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC,CAC/E;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE;QAC1G,WAAW,EAAE,kDAAkD;KAChE,CAAC,CACH;CACF,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,kBAAkB,GAE3B;IACF,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,2KAA2K;IAC7K,UAAU,EAAE,MAAM;IAClB,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI;QAC5B,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;QAClC,OAAO,kBAAkB,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,IAAI,CAAC,KAAK,uDAAuD,EAAE,CAAC;gBACzI,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAG,IAAI,CAAC,MAAc,IAAI,WAAW,CAAC,CAAC;QAExE,MAAM,KAAK,GAAG;YACZ,0BAA0B,IAAI,CAAC,KAAK,QAAQ,IAAI,KAAK;YACrD,EAAE;YACF,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;YAClG,QAAQ,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,KAAK,EAAE;SAC9D,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7F,CAAC;CACF,CAAC"}

package/dist/tools/sentiment/twitter-sentiment.d.ts

@@ -0,0 +1,9 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { TwitterSentimentResult } from "../../types/sentiment.js";
+declare const params: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    hours: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare const twitterSentimentTool: AgentTool<typeof params, TwitterSentimentResult>;
+export {};

package/dist/tools/sentiment/twitter-sentiment.js

@@ -0,0 +1,75 @@
+import { Type } from "@sinclair/typebox";
+import { getTwitterSentiment } from "../../providers/twitter.js";
+import { wrapProvider } from "../../providers/wrap-provider.js";
+import { TwitterAdapter } from "../../sentiment/adapters/twitter.js";
+import { getSentimentPipeline } from "../../sentiment/index.js";
+const params = Type.Object({
+    query: Type.String({
+        description: "Stock ticker (e.g. AAPL) or search term (e.g. 'AAPL earnings call')",
+    }),
+    limit: Type.Optional(Type.Number({ description: "Max tweets to fetch. Default: 50, max: 200" })),
+    hours: Type.Optional(Type.Number({ description: "Lookback window in hours. Default: 24" })),
+});
+export const twitterSentimentTool = {
+    name: "get_twitter_sentiment",
+    label: "Twitter Sentiment",
+    description: "Fetch recent tweets for a stock ticker or search query and compute engagement-weighted sentiment. Returns tweet data, sentiment score, and co-mentioned tickers. Requires a Twitter session via trigger_twitter_login.",
+    parameters: params,
+    async execute(toolCallId, args) {
+        const limit = Math.min(args.limit ?? 50, 200);
+        const hours = args.hours ?? 24;
+        const providerResult = await wrapProvider("twitter", () => getTwitterSentiment(args.query, limit, hours));
+        if (providerResult.status === "unavailable") {
+            const isLoginIssue = providerResult.reason.includes("No Twitter session") ||
+                providerResult.reason.includes("session expired");
+            const text = isLoginIssue
+                ? `⚠ Twitter sentiment unavailable: ${providerResult.reason}\n[LOGIN_NEEDED] Use ask_user to confirm, then call trigger_twitter_login. After success, retry this tool.`
+                : `⚠ Twitter sentiment unavailable (${providerResult.reason}).`;
+            return {
+                content: [{ type: "text", text }],
+                details: null,
+            };
+        }
+        const result = providerResult.data;
+        const sentimentLabel = result.sentimentScore > 0.3 ? "Bullish" :
+            result.sentimentScore < -0.3 ? "Bearish" :
+                result.sentimentScore > 0 ? "Leaning Bullish" :
+                    result.sentimentScore < 0 ? "Leaning Bearish" : "Neutral";
+        const lines = [
+            `**Twitter: ${result.query}** — ${result.tweetCount} tweets (last ${hours}h, ${result.fetchedAt})`,
+            `Sentiment: ${result.sentimentScore.toFixed(2)} (${sentimentLabel}) | Bullish: ${result.bullishCount} | Bearish: ${result.bearishCount}`,
+        ];
+        if (result.topMentions.length > 0) {
+            lines.push(`Co-mentions: ${result.topMentions.map((t) => `$${t}`).join(", ")}`);
+        }
+        lines.push("");
+        lines.push("| Author | Tweet | ❤️ | 🔁 | 💬 |");
+        lines.push("|--------|-------|----|----|----|");
+        const top = result.tweets.slice(0, 15);
+        for (const tweet of top) {
+            const text = tweet.text.replace(/\|/g, "\\|").replace(/\n/g, " ").slice(0, 100);
+            lines.push(`| @${tweet.author} | ${text} | ${tweet.likes} | ${tweet.retweets} | ${tweet.replies} |`);
+        }
+        if (providerResult.stale) {
+            lines.push("");
+            lines.push(`⚠ Stale data (cached at ${providerResult.timestamp})`);
+        }
+        // Index in sentiment store and append trend context
+        try {
+            const adapter = new TwitterAdapter();
+            const records = adapter.mapToRecords(result, args.query);
+            const pipeline = getSentimentPipeline();
+            const pipelineResult = await pipeline.processRecords(records, args.query);
+            if (pipelineResult.trend && pipelineResult.trend.length > 0) {
+                const t = pipelineResult.trend[0];
+                lines.push("");
+                lines.push(`Trend: ${t.sparkline} ${t.direction} (${t.delta >= 0 ? "+" : ""}${t.delta.toFixed(2)}, ${t.count} records)`);
+            }
+        }
+        catch {
+            // Sentiment indexing is best-effort — don't fail the tool
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }], details: result };
+    },
+};
+//# sourceMappingURL=twitter-sentiment.js.map

package/dist/tools/sentiment/twitter-sentiment.js.map

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

package/dist/tools/sentiment/web-search.d.ts

@@ -0,0 +1,11 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { WebSearchEnvelope } from "../../types/sentiment.js";
+declare const params: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    category: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"news">, import("@sinclair/typebox").TLiteral<"general">]>>;
+    freshness: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"hours">, import("@sinclair/typebox").TLiteral<"day">, import("@sinclair/typebox").TLiteral<"week">, import("@sinclair/typebox").TLiteral<"month">]>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    provider: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"exa">, import("@sinclair/typebox").TLiteral<"brave">, import("@sinclair/typebox").TLiteral<"ddg">]>>;
+}>;
+export declare const webSearchTool: AgentTool<typeof params, WebSearchEnvelope>;
+export {};

package/dist/tools/sentiment/web-search.js

@@ -0,0 +1,115 @@
+import { Type } from "@sinclair/typebox";
+import { searchWeb } from "../../providers/web-search.js";
+import { hasCredential } from "../../onboarding/providers.js";
+import { buildSoftDegradedTag } from "../../onboarding/tool-tags.js";
+const params = Type.Object({
+    query: Type.String({ description: "Search query — ticker, topic, or question" }),
+    category: Type.Optional(Type.Union([Type.Literal("news"), Type.Literal("general")], {
+        description: 'Search category. "news" for recent articles, "general" for broader web. Default: "news"',
+    })),
+    freshness: Type.Optional(Type.Union([Type.Literal("hours"), Type.Literal("day"), Type.Literal("week"), Type.Literal("month")], { description: 'Time range filter. Default: "day"' })),
+    limit: Type.Optional(Type.Number({ description: "Number of results (1-20). Default: 10", minimum: 1, maximum: 20 })),
+    provider: Type.Optional(Type.Union([Type.Literal("exa"), Type.Literal("brave"), Type.Literal("ddg")], {
+        description: "Override search provider (skip cascade). Default: auto (Exa → Brave → DDG)",
+    })),
+});
+function escapeMd(text) {
+    return text.replace(/([[\]|])/g, "\\$1");
+}
+function safeUrl(url) {
+    if (url.startsWith("https://") || url.startsWith("http://"))
+        return url;
+    return `https://${url}`;
+}
+/**
+ * Build soft-degradation tags for search providers whose credentials are
+ * missing at call time. Returns an empty string when nothing is degraded, or
+ * a newline-terminated block of `[OPENCANDLE_SOFT_DEGRADED ...]` tags ready to
+ * prepend to the tool result content. The extension's `tool_result` handler
+ * records these into the per-turn degradation accumulator; the system prompt
+ * instructs the LLM to surface them in a `**Data gaps**` section.
+ *
+ * Emission rules:
+ *   - Brave: if `hasCredential("brave") === false` AND the envelope's
+ *     provider is not `"brave"`, the cascade fell back from Brave.
+ *   - Exa:   if `hasCredential("exa") === false` AND the envelope's provider
+ *     is `"exa"`, the Exa provider used the keyless MCP path instead of the
+ *     keyed API. Envelopes served by `ddg` are NOT tagged for Exa (Exa was
+ *     tried first and failed for a reason unrelated to credentials).
+ */
+function buildSoftDegradedPrefix(data) {
+    const tags = [];
+    if (!hasCredential("brave") && data.provider !== "brave") {
+        tags.push(buildSoftDegradedTag({
+            provider: "brave",
+            fallback: data.provider === "exa" ? "exa" : "ddg",
+            remediation: "run /connect search to enable Brave",
+        }));
+    }
+    if (!hasCredential("exa") && data.provider === "exa") {
+        tags.push(buildSoftDegradedTag({
+            provider: "exa",
+            fallback: "keyless-mcp",
+            remediation: "run /connect search to enable keyed Exa",
+        }));
+    }
+    return tags.length === 0 ? "" : `${tags.join("\n")}\n\n`;
+}
+export const webSearchTool = {
+    name: "search_web",
+    label: "Web Search",
+    description: "Search the web for financial news, earnings context, company events, regulatory developments, or general information. " +
+        "NOT for real-time prices, historical data, fundamentals, macro data, SEC filings, or social sentiment — those have dedicated tools.",
+    parameters: params,
+    async execute(toolCallId, args) {
+        const query = args.query?.trim();
+        if (!query) {
+            return {
+                content: [{ type: "text", text: "⚠ Cannot search with an empty query." }],
+                details: null,
+            };
+        }
+        const category = args.category ?? "news";
+        const freshness = args.freshness ?? "day";
+        const limit = Math.max(1, Math.min(args.limit ?? 10, 20));
+        const provider = args.provider;
+        const result = await searchWeb(query, { category, freshness, limit, provider });
+        if (result.status === "unavailable") {
+            return {
+                content: [{ type: "text", text: `⚠ Web search unavailable (${result.reason}).` }],
+                details: null,
+            };
+        }
+        const data = result.data;
+        if (data.resultCount === 0) {
+            const zeroPrefix = buildSoftDegradedPrefix(data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${zeroPrefix}No results found for "${query}" (${category}, past ${freshness}).`,
+                    },
+                ],
+                details: data,
+            };
+        }
+        const stalePrefix = result.stale
+            ? `⚠ Using cached data from ${result.timestamp}\n\n`
+            : "";
+        const softDegradedPrefix = buildSoftDegradedPrefix(data);
+        const header = `**Web Search** — ${data.resultCount} results for "${query}" (${category}, past ${freshness}, via ${data.provider})`;
+        const items = data.results.map((r) => {
+            const title = escapeMd(r.title);
+            const snippet = escapeMd(r.snippet);
+            const url = safeUrl(r.url);
+            const pub = r.published ? `Published: ${r.published}` : "Published: unknown";
+            return `• [${title}](${url}) — ${r.source}\n  ${snippet}\n  ${pub}`;
+        });
+        const text = `${softDegradedPrefix}${stalePrefix}${header}\n\n${items.join("\n\n")}`;
+        return {
+            content: [{ type: "text", text }],
+            details: data,
+        };
+    },
+};
+//# sourceMappingURL=web-search.js.map

package/dist/tools/sentiment/web-search.js.map

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

package/dist/tools/sentiment/web-sentiment.d.ts

@@ -0,0 +1,8 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+declare const params: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    freshness: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"day">, import("@sinclair/typebox").TLiteral<"week">, import("@sinclair/typebox").TLiteral<"month">]>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare const webSentimentTool: AgentTool<typeof params>;
+export {};

package/dist/tools/sentiment/web-sentiment.js

@@ -0,0 +1,66 @@
+import { Type } from "@sinclair/typebox";
+import { searchWeb } from "../../providers/web-search.js";
+import { WebAdapter } from "../../sentiment/adapters/web.js";
+import { getSentimentPipeline } from "../../sentiment/index.js";
+const params = Type.Object({
+    query: Type.String({ description: "Ticker or topic to search for web/news sentiment" }),
+    freshness: Type.Optional(Type.Union([Type.Literal("day"), Type.Literal("week"), Type.Literal("month")], {
+        description: "Time window for results. Default: day",
+    })),
+    limit: Type.Optional(Type.Number({ description: "Max results. Default: 10, max: 20" })),
+});
+export const webSentimentTool = {
+    name: "get_web_sentiment",
+    label: "Web/News Sentiment",
+    description: "Analyze sentiment from web and news search results for a ticker or topic. Returns scored results with aggregate sentiment.",
+    parameters: params,
+    async execute(toolCallId, args) {
+        const freshness = args.freshness ?? "day";
+        const limit = Math.min(args.limit ?? 10, 20);
+        const providerResult = await searchWeb(args.query, { freshness, limit, category: "news" });
+        if (providerResult.status === "unavailable") {
+            return {
+                content: [{ type: "text", text: `⚠ Web sentiment unavailable for "${args.query}" (${providerResult.reason}).` }],
+                details: null,
+            };
+        }
+        const adapter = new WebAdapter();
+        const records = adapter.mapToRecords(providerResult.data, args.query);
+        const pipeline = getSentimentPipeline();
+        const result = await pipeline.processRecords(records, args.query);
+        const lines = [];
+        if (result.fresh.length === 0) {
+            lines.push(`No web results found for "${args.query}".`);
+        }
+        else {
+            const avgScore = result.fresh.reduce((s, r) => s + r.sentiment.score, 0) / result.fresh.length;
+            const label = sentimentLabel(avgScore);
+            lines.push(`**Web sentiment for "${args.query}"** — ${result.fresh.length} results (${label}, ${avgScore.toFixed(2)})`);
+            lines.push("");
+            for (const rec of result.fresh.slice(0, limit)) {
+                const indicator = rec.sentiment.score > 0 ? "🟢" : rec.sentiment.score < 0 ? "🔴" : "⚪";
+                lines.push(`${indicator} [${rec.title}](${rec.url}) — *${rec.author}*`);
+                lines.push(`  ${rec.text.slice(0, 150)}`);
+                lines.push(`  Score: ${rec.sentiment.score.toFixed(2)} | Confidence: ${rec.sentiment.confidence.toFixed(2)}`);
+            }
+            if (result.trend) {
+                lines.push("");
+                const t = result.trend[0];
+                lines.push(`Trend: ${t.sparkline} ${t.direction} (${t.count} records)`);
+            }
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }], details: result };
+    },
+};
+function sentimentLabel(score) {
+    if (score > 0.3)
+        return "Bullish";
+    if (score < -0.3)
+        return "Bearish";
+    if (score > 0)
+        return "Leaning Bullish";
+    if (score < 0)
+        return "Leaning Bearish";
+    return "Neutral";
+}
+//# sourceMappingURL=web-sentiment.js.map