opencandle 0.2.0 → 0.3.0

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

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

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

package/dist/types/index.d.ts

@@ -4,7 +4,7 @@ export type { FredObservation, FredSeries } from "./macro.js";
 export { FRED_SERIES } from "./macro.js";
 export type { Greeks, OptionContract, OptionsChain } from "./options.js";
 export type { Position, PortfolioSummary, RiskMetrics, TechnicalIndicators } from "./portfolio.js";
-export type { FearGreedData, RedditSentimentResult } from "./sentiment.js";
+export type { FearGreedData, RedditSentimentResult, WebSearchResult, WebSearchEnvelope } from "./sentiment.js";
 /**
  * Handler for `ask_user` tool invocations in non-UI contexts (e.g. test harness).
  * When provided to `createOpenCandleSession`, the ask-user tool calls this handler

package/dist/types/sentiment.d.ts

@@ -7,6 +7,7 @@ export interface FearGreedData {
     monthAgo: number | null;
 }
 export interface TwitterTweet {
+    id: string;
     text: string;
     author: string;
     likes: number;
@@ -26,11 +27,31 @@ export interface TwitterSentimentResult {
     topMentions: string[];
     fetchedAt: string;
 }
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    /** Domain extracted from url (e.g., "reuters.com") */
+    source: string;
+    /** ISO 8601 timestamp, null if unknown */
+    published: string | null;
+    category: "news" | "general";
+}
+export interface WebSearchEnvelope {
+    query: string;
+    results: WebSearchResult[];
+    resultCount: number;
+    fetchedAt: string;
+    provider: "ddg" | "brave" | "exa";
+}
 export interface RedditSentimentResult {
     subreddit: string;
     postCount: number;
     posts: Array<{
+        id: string;
         title: string;
+        selftext: string;
+        author: string;
         score: number;
         comments: number;
         url: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencandle",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Financial trading & investing agent",
   "license": "MIT",
   "homepage": "https://github.com/Kahtaf/OpenCandle#readme",
@@ -43,9 +43,20 @@
     ]
   },
   "keywords": [
-    "pi-package",
     "opencandle",
-    "finance"
+    "finance",
+    "stock",
+    "investing",
+    "trading",
+    "options",
+    "market-data",
+    "portfolio",
+    "ai-agent",
+    "terminal",
+    "financial-analysis",
+    "sentiment",
+    "technical-analysis",
+    "pi-package"
   ],
   "files": [
     "dist"
@@ -58,6 +69,10 @@
     "test:watch": "vitest",
     "test:e2e": "tsx tests/e2e/tools.test.ts",
     "test:e2e:cli": "tsx tests/e2e/cli.test.ts",
+    "test:e2e:credential-prompt": "tsx tests/e2e/credential-prompt.test.ts",
+    "test:e2e:credential-snooze": "tsx tests/e2e/credential-snooze.test.ts",
+    "test:e2e:credential-soft-fallback": "tsx tests/e2e/credential-soft-fallback.test.ts",
+    "test:e2e:credential-per-workflow-cap": "tsx tests/e2e/credential-per-workflow-cap.test.ts",
     "test:e2e:providers": "tsx tests/e2e/providers.test.ts",
     "test:evals": "vitest run --config vitest.config.evals.ts",
     "test:evals:usually": "EVAL_TIER=usually vitest run --config vitest.config.evals.ts",
@@ -78,6 +93,7 @@
     "@the-convocation/twitter-scraper": "^0.22.3",
     "better-sqlite3": "^12.8.0",
     "camoufox-js": "^0.9.3",
+    "duck-duck-scrape": "^2.2.7",
     "playwright-core": "^1.58.2"
   },
   "peerDependencies": {

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

@@ -1,7 +0,0 @@
-import type { AgentTool } from "@mariozechner/pi-agent-core";
-import type { RedditSentimentResult } from "../../types/sentiment.js";
-declare const params: import("@sinclair/typebox").TObject<{
-    topic: import("@sinclair/typebox").TString;
-}>;
-export declare const newsSentimentTool: AgentTool<typeof params, RedditSentimentResult>;
-export {};

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

@@ -1,55 +0,0 @@
-import { Type } from "@sinclair/typebox";
-import { getSubredditPosts } from "../../providers/reddit.js";
-import { wrapProvider } from "../../providers/wrap-provider.js";
-const params = Type.Object({
-    topic: Type.String({
-        description: "Topic or ticker to search for news sentiment (e.g. AAPL, bitcoin, inflation)",
-    }),
-});
-export const newsSentimentTool = {
-    name: "get_reddit_discussions",
-    label: "Reddit Financial Discussions",
-    description: "Search financial Reddit communities (r/stocks, r/investing) for recent discussions about a topic. Useful for gauging retail sentiment, but not a substitute for news or institutional analysis.",
-    parameters: params,
-    async execute(toolCallId, args) {
-        // Use r/stocks and r/investing as news proxies
-        const subreddits = ["stocks", "investing"];
-        const allPosts = [];
-        const allMentions = [];
-        for (const sub of subreddits) {
-            const providerResult = await wrapProvider("reddit", () => getSubredditPosts(sub, 25));
-            if (providerResult.status === "unavailable")
-                continue;
-            const result = providerResult.data;
-            const relevant = result.posts.filter((p) => p.title.toLowerCase().includes(args.topic.toLowerCase()));
-            allPosts.push(...relevant);
-            allMentions.push(...result.topMentions);
-        }
-        const uniqueMentions = [...new Set(allMentions)];
-        const text = [
-            `**Reddit Discussions for "${args.topic}"** — ${allPosts.length} relevant posts found`,
-            uniqueMentions.length > 0
-                ? `Related tickers: ${uniqueMentions.map((t) => `$${t}`).join(", ")}`
-                : "",
-            "",
-            ...allPosts.slice(0, 10).map((p) => `  ⬆${p.score} 💬${p.comments} — ${p.title.slice(0, 100)}`),
-            allPosts.length === 0 ? "No relevant discussions found. Try broader search terms." : "",
-        ]
-            .filter(Boolean)
-            .join("\n");
-        return {
-            content: [{ type: "text", text }],
-            details: {
-                subreddit: "stocks+investing",
-                postCount: allPosts.length,
-                posts: allPosts,
-                topMentions: uniqueMentions,
-                sentimentScore: 0,
-                bullishCount: 0,
-                bearishCount: 0,
-                fetchedAt: new Date().toISOString(),
-            },
-        };
-    },
-};
-//# sourceMappingURL=news-sentiment.js.map

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

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