opencandle 0.4.0 → 0.6.0

package/src/sentiment/adapters/reddit.ts

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
-import type { SentinelRecord, SentimentAdapter } from "../types.js";
-import type { RedditSentimentResult } from "../../types/sentiment.js";
 import type { RedditComment } from "../../providers/reddit.js";
+import type { RedditSentimentResult } from "../../types/sentiment.js";
+import type { SentimentAdapter, SentinelRecord } from "../types.js";
 
 export class RedditAdapter implements SentimentAdapter {
   readonly source = "reddit" as const;

package/src/sentiment/adapters/twitter.ts

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
-import type { SentinelRecord, SentimentAdapter } from "../types.js";
 import type { TwitterSentimentResult } from "../../types/sentiment.js";
+import type { SentimentAdapter, SentinelRecord } from "../types.js";
 
 export class TwitterAdapter implements SentimentAdapter {
   readonly source = "twitter" as const;

package/src/sentiment/adapters/web.ts

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
-import type { SentinelRecord, SentimentAdapter } from "../types.js";
 import type { WebSearchEnvelope } from "../../types/sentiment.js";
+import type { SentimentAdapter, SentinelRecord } from "../types.js";
 
 export class WebAdapter implements SentimentAdapter {
   readonly source = "web" as const;

package/src/sentiment/index.ts

@@ -1,30 +1,29 @@
+export { RedditAdapter } from "./adapters/reddit.js";
+export { TwitterAdapter } from "./adapters/twitter.js";
+export { WebAdapter } from "./adapters/web.js";
+export { BEARISH_TERMS, BULLISH_TERMS } from "./keywords.js";
+export { SentimentPipeline } from "./pipeline.js";
+export { keywordScore, scoreRecords } from "./scorer.js";
+export { SentimentStore } from "./store.js";
+export { computeDivergence, computeTrend, renderSparkline } from "./trends.js";
 export type {
-  SentinelRecord,
+  DivergenceResult,
+  ScorerOptions,
+  SentimentAdapter,
+  SentimentSource,
+  SentimentSummary,
   SentinelEngagement,
+  SentinelRecord,
   SentinelSentiment,
-  SentimentAdapter,
-  ScorerOptions,
   TrendBucket,
   TrendResult,
-  DivergenceResult,
-  SentimentSummary,
-  SentimentSource,
 } from "./types.js";
-
 export { isSentinelRecord, SENTIMENT_SOURCES } from "./types.js";
-export { SentimentStore } from "./store.js";
-export { scoreRecords, keywordScore } from "./scorer.js";
-export { SentimentPipeline } from "./pipeline.js";
-export { renderSparkline, computeTrend, computeDivergence } from "./trends.js";
-export { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
-export { TwitterAdapter } from "./adapters/twitter.js";
-export { RedditAdapter } from "./adapters/reddit.js";
-export { WebAdapter } from "./adapters/web.js";
 
-import { SentimentStore } from "./store.js";
-import { SentimentPipeline } from "./pipeline.js";
 import { getConfig } from "../config.js";
 import { resolveOpenCandlePath } from "../infra/opencandle-paths.js";
+import { SentimentPipeline } from "./pipeline.js";
+import { SentimentStore } from "./store.js";
 
 let _pipeline: SentimentPipeline | null = null;
 let _store: SentimentStore | null = null;
@@ -47,12 +46,3 @@ export function getSentimentPipeline(): SentimentPipeline {
   }
   return _pipeline;
 }
-
-/** For testing: reset singletons */
-export function _resetSentimentSingletons(): void {
-  if (_store) {
-    try { _store.close(); } catch { /* ignore */ }
-  }
-  _pipeline = null;
-  _store = null;
-}

package/src/sentiment/keywords.ts

@@ -1,9 +1,31 @@
 export const BULLISH_TERMS = [
-  "moon", "buy", "undervalued", "breakout", "calls", "bullish",
-  "rocket", "diamond hands", "accumulate", "dip buy", "long", "rip", "squeeze",
+  "moon",
+  "buy",
+  "undervalued",
+  "breakout",
+  "calls",
+  "bullish",
+  "rocket",
+  "diamond hands",
+  "accumulate",
+  "dip buy",
+  "long",
+  "rip",
+  "squeeze",
 ] as const;
 
 export const BEARISH_TERMS = [
-  "crash", "overvalued", "sell", "puts", "bearish", "bubble",
-  "dump", "short", "bagholding", "exit", "drill", "tank", "rug",
+  "crash",
+  "overvalued",
+  "sell",
+  "puts",
+  "bearish",
+  "bubble",
+  "dump",
+  "short",
+  "bagholding",
+  "exit",
+  "drill",
+  "tank",
+  "rug",
 ] as const;

package/src/sentiment/pipeline.ts

@@ -1,8 +1,14 @@
-import type { SentinelRecord, SentimentSummary, TrendResult, DivergenceResult, SentimentSource } from "./types.js";
 import type { SentimentConfig } from "../config.js";
 import { scoreRecords } from "./scorer.js";
-import { SentimentStore } from "./store.js";
-import { computeTrend, computeDivergence, type SourceStats } from "./trends.js";
+import type { SentimentStore } from "./store.js";
+import { computeDivergence, computeTrend, type SourceStats } from "./trends.js";
+import type {
+  DivergenceResult,
+  SentimentSource,
+  SentimentSummary,
+  SentinelRecord,
+  TrendResult,
+} from "./types.js";
 
 export class SentimentPipeline {
   constructor(
@@ -39,7 +45,12 @@ export class SentimentPipeline {
     // Compute divergence from fresh records
     let divergence: DivergenceResult | null = null;
     const sourceGroups = groupBySource(scored);
-    const sourceStats: { twitter?: SourceStats; reddit?: SourceStats; web?: SourceStats; finnhub?: SourceStats } = {};
+    const sourceStats: {
+      twitter?: SourceStats;
+      reddit?: SourceStats;
+      web?: SourceStats;
+      finnhub?: SourceStats;
+    } = {};
 
     for (const [source, recs] of Object.entries(sourceGroups)) {
       // Exclude comments from divergence calculation

package/src/sentiment/scorer.ts

@@ -1,4 +1,4 @@
-import { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
+import { BEARISH_TERMS, BULLISH_TERMS } from "./keywords.js";
 import type { SentinelRecord } from "./types.js";
 
 const TICKER_REGEX = /\$([A-Z]{1,5})\b/g;

package/src/sentiment/store.ts

@@ -1,7 +1,7 @@
-import Database from "better-sqlite3";
 import { mkdirSync } from "node:fs";
 import { dirname } from "node:path";
-import type { SentinelRecord, SentimentSource, TrendBucket } from "./types.js";
+import Database from "better-sqlite3";
+import type { SentimentSource, SentinelRecord, TrendBucket } from "./types.js";
 
 const SCHEMA_VERSION = 1;
 

package/src/sentiment/trends.ts

@@ -1,4 +1,4 @@
-import type { TrendBucket, TrendResult, DivergenceResult, SentimentSource } from "./types.js";
+import type { DivergenceResult, SentimentSource, TrendBucket, TrendResult } from "./types.js";
 
 const SPARKLINE_CHARS = "▁▂▃▄▅▆▇█";
 
@@ -24,7 +24,8 @@ export function computeTrend(
 ): TrendResult {
   const scores = buckets.map((b) => b.avgScore);
   const totalCount = buckets.reduce((sum, b) => sum + b.count, 0);
-  const avgScore = totalCount === 0 ? 0 : buckets.reduce((sum, b) => sum + b.avgScore * b.count, 0) / totalCount;
+  const avgScore =
+    totalCount === 0 ? 0 : buckets.reduce((sum, b) => sum + b.avgScore * b.count, 0) / totalCount;
 
   const sparkline = renderSparkline(scores);
 
@@ -45,7 +46,12 @@ export interface SourceStats {
 }
 
 export function computeDivergence(
-  sources: { twitter?: SourceStats; reddit?: SourceStats; web?: SourceStats; finnhub?: SourceStats },
+  sources: {
+    twitter?: SourceStats;
+    reddit?: SourceStats;
+    web?: SourceStats;
+    finnhub?: SourceStats;
+  },
   threshold: number,
 ): DivergenceResult {
   const retailSources: SourceStats[] = [];

package/src/sentiment/types.ts

@@ -9,9 +9,9 @@ export interface SentinelEngagement {
 }
 
 export interface SentinelSentiment {
-  score: number;       // -1.0 to +1.0
-  confidence: number;  // 0.0 to 1.0
-  method: "keyword";   // v1 is keyword-only; future: "llm"
+  score: number; // -1.0 to +1.0
+  confidence: number; // 0.0 to 1.0
+  method: "keyword"; // v1 is keyword-only; future: "llm"
   tickers: string[];
 }
 
@@ -36,7 +36,8 @@ export function isSentinelRecord(val: unknown): val is SentinelRecord {
   const r = val as Record<string, unknown>;
 
   if (typeof r.id !== "string") return false;
-  if (typeof r.source !== "string" || !SENTIMENT_SOURCES.includes(r.source as SentimentSource)) return false;
+  if (typeof r.source !== "string" || !SENTIMENT_SOURCES.includes(r.source as SentimentSource))
+    return false;
   if (typeof r.sourceId !== "string") return false;
   if (typeof r.query !== "string") return false;
   if (r.title !== null && typeof r.title !== "string") return false;

package/src/system-prompt.ts

@@ -10,16 +10,16 @@ ${memoryContext}`
   return `You are OpenCandle, a research analyst for investors and traders.
 
 ## Your Role
-You are an analyst, not a fiduciary advisor. When asked for entry levels, price targets, stops, position sizes, or allocations, you COMMIT to specific numbers backed by the data you fetched. Uncertainty is expressed as a confidence band and an invalidation level — not as refusal. Refusal-shaped hedges are wrong for this product: users come here for an analyst's view, and an analyst who won't commit is useless.
+You are an analyst, not a fiduciary advisor. When asked for entry levels, price targets, stops, position sizes, or allocations, you COMMIT to specific numbers backed by the data you fetched. Uncertainty is expressed as a confidence band and an invalidation level — not as refusal. Refusal-shaped hedges are wrong for this product: users come here for an analyst's view, and an analyst who won't commit is useless. For conceptual education questions, teach the concept directly, do not name tool functions, and do not append analyst-view, confidence-band, or invalidation boilerplate. For valuation-metric education, start with "Bottom line", use a heading exactly named "Practical workflow" with numbered question-driven application steps, explain where the metric misleads, include a compact cross-check table with why/when each metric helps, include relevant trailing, forward, normalized, or cyclically adjusted variants when useful, and end with a heading exactly named "Quick checklist".
 
 ## Available Tools
-- **Market Data**: get_stock_quote, get_stock_history, get_crypto_price, get_crypto_history — real-time and historical price data
+- **Market Data**: screen_stocks, get_stock_quote, get_stock_history, get_crypto_price, get_crypto_history — use screen_stocks for breadth and screening prompts such as large-cap lists, oversold stocks, market movers, and filtered market scans; use get_stock_quote/get_stock_history for a single-security quote or historical OHLCV
 - **Fundamentals**: get_company_overview, get_financials, get_earnings, compute_dcf, compare_companies, get_sec_filings — company financials, valuation metrics, DCF intrinsic value, peer comparison, and SEC EDGAR filings (10-K, 10-Q, 8-K)
 - **Technical Analysis**: get_technical_indicators, backtest_strategy — SMA, EMA, RSI, MACD, Bollinger Bands, OBV, VWAP computed from price data, plus simple strategy backtesting
 - **Macro**: get_economic_data, get_fear_greed — FRED economic indicators and market sentiment
 - **Sentiment**: get_reddit_sentiment, get_twitter_sentiment, get_web_sentiment, get_sentiment_trend, get_sentiment_summary — retail and news sentiment from Reddit, Twitter/X, and web sources with historical trends
 - **Options**: get_option_chain — full options chain with strikes, bids/asks, volume, OI, IV, and computed Greeks (delta, gamma, theta, vega, rho)
-- **Portfolio**: track_portfolio, analyze_risk, manage_watchlist, analyze_correlation, track_prediction — position tracking, P&L, Sharpe ratio, VaR, watchlist with price alerts, correlation matrix, and prediction tracking with accuracy scoring
+- **Portfolio**: track_portfolio, analyze_risk, manage_watchlist, analyze_correlation, track_prediction, manage_alerts, daily_watchlist_report, manage_notifications — position tracking, P&L, Sharpe ratio, VaR, watchlist tracking, durable local alerts, daily watchlist reports, notification history, correlation matrix, and prediction tracking with accuracy scoring
 - **User Interaction**: ask_user — ask clarification questions; trigger_twitter_login — open a browser for Twitter/X login
 
 ## Analytical Framework
@@ -45,11 +45,15 @@ Calibrate explanation depth from conversational signals: the user's vocabulary i
 
 ## Guidelines
 - Always fetch data with tools before stating prices, ratios, or metrics. Never guess financial numbers. Every substantive response should be backed by at least one tool call — if you find yourself writing a response with zero tool calls, stop and think about what data would make it better.
+- Use screen_stocks for breadth and screening prompts ("which large caps...", "find oversold stocks...", "market movers by filter"). Use get_stock_quote, get_stock_history, get_option_chain, fundamentals, and analysis workflows for single-security quote, history, options, DCF, or company-analysis prompts.
+- For current single-stock recommendations, state the quote or tool-output date in the final answer. If tool output says the market is closed, the quote is delayed, or this is the last available quote, carry that freshness note into the final answer. If DCF or another valuation model is unavailable or not meaningful, do not let that tool failure become the whole valuation view; use supported fallback valuation lenses such as relative multiples, growth-adjusted multiples, cash-flow quality, balance-sheet risk, and historical range context. Do not make missing fundamentals the main thesis when quote, earnings, technicals, sentiment, or news are available; use those data points plus structural business risks to give a clear call, position sizing, and entry strategy.
+- For ticker-specific sentiment prompts, call get_stock_quote before the final answer and state whether sentiment diverges from price action. For sentiment-only prompts, include source-coverage risk, low sample counts, missing sources, and how those gaps downgrade confidence.
 - For options analysis, use get_option_chain to see the full chain with Greeks. Pay attention to put/call ratio, unusual volume, and IV levels.
 - Present numerical data in tables when comparing multiple securities.
 - Include data timestamps so users know how fresh the information is.
 - Be concise and actionable. Lead with the commitment, then the reasoning chain.
 - Flag downside and risks loudly. Commitment is not optimism — a bearish analyst view with conviction is valid output. Risk is expressed through the invalidation level and confidence band, never through refusal.
+- Conceptual education prompts are not committal responses. Do not append "Analyst View", "Commitment", "Reasoning Chain", "Confidence Band", or "Invalidation Level" sections when the user asked for an explanation, definition, or learning framework rather than a trade, allocation, or recommendation.
 - Reuse prior tool outputs when they already answer the question. Do not re-fetch the same symbol and parameters unless you need a missing field or fresher timestamp.
 - If one provider is missing data, continue with the remaining tools and clearly label unavailable metrics instead of aborting the entire response.
 

package/src/tool-kit.ts

@@ -1,16 +1,16 @@
-import type { TSchema } from "@sinclair/typebox";
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { TSchema } from "@sinclair/typebox";
 import { agentToolToPiTool } from "./pi/tool-adapter.js";
 
+export type { AgentTool } from "@earendil-works/pi-agent-core";
+export type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export { Type } from "@sinclair/typebox";
 // Re-exports for tool authors — import from "opencandle/tool-kit"
-export { cache, Cache, TTL } from "./infra/cache.js";
-export { rateLimiter, RateLimiter } from "./infra/rate-limiter.js";
-export { httpGet, HttpError, type HttpClientOptions } from "./infra/http-client.js";
+export { Cache, cache, TTL } from "./infra/cache.js";
+export { type HttpClientOptions, HttpError, httpGet } from "./infra/http-client.js";
+export { RateLimiter, rateLimiter } from "./infra/rate-limiter.js";
 export { agentToolToPiTool } from "./pi/tool-adapter.js";
-export { Type } from "@sinclair/typebox";
-export type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-export type { AgentTool } from "@earendil-works/pi-agent-core";
 
 // Module-level registry — all extensions run in the same Node.js process,
 // so keep a deduped index keyed by tool name.
@@ -20,7 +20,8 @@ export function getAddonToolDescriptions(): ReadonlyArray<{ name: string; descri
   return Array.from(addonToolRegistry.values());
 }
 
-const SNAKE_CASE_VERB_RE = /^(get|analyze|search|calculate|compare|compute|track|manage|backtest|list|fetch|check)_[a-z][a-z0-9_]*$/;
+const SNAKE_CASE_VERB_RE =
+  /^(get|analyze|search|calculate|compare|compute|track|manage|backtest|list|fetch|check)_[a-z][a-z0-9_]*$/;
 
 export interface ToolConfig<TParams extends TSchema, TDetails = unknown> {
   name: string;
@@ -36,7 +37,7 @@ export function createTool<TParams extends TSchema, TDetails = unknown>(
   if (!config.name || !SNAKE_CASE_VERB_RE.test(config.name)) {
     throw new Error(
       `Invalid tool name "${config.name}": must be snake_case and start with a verb prefix ` +
-      `(get_, analyze_, search_, calculate_, compare_, compute_, track_, manage_, backtest_, list_, fetch_, check_)`,
+        `(get_, analyze_, search_, calculate_, compare_, compute_, track_, manage_, backtest_, list_, fetch_, check_)`,
     );
   }
   if (!config.description || config.description.trim().length === 0) {

package/src/tools/fundamentals/company-overview.ts

@@ -1,28 +1,38 @@
-import { Type } from "@sinclair/typebox";
 import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { getOverview } from "../../providers/alpha-vantage.js";
-import { wrapProvider } from "../../providers/wrap-provider.js";
+import { Type } from "@sinclair/typebox";
 import { getConfig } from "../../config.js";
 import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
+import { getOverview } from "../../providers/alpha-vantage.js";
+import { wrapProvider } from "../../providers/wrap-provider.js";
 import type { CompanyOverview } from "../../types/fundamentals.js";
 
 const params = Type.Object({
   symbol: Type.String({ description: "Stock ticker symbol (e.g. AAPL, MSFT)" }),
 });
 
-export const companyOverviewTool: AgentTool<typeof params, CompanyOverview | { credentialRequired: unknown }> = {
+export const companyOverviewTool: AgentTool<
+  typeof params,
+  CompanyOverview | { credentialRequired: unknown }
+> = {
   name: "get_company_overview",
   label: "Company Overview",
   description:
     "Get company fundamentals: P/E ratio, EPS, market cap, sector, dividend yield, profit margin, beta, and description. Requires Alpha Vantage.",
   parameters: params,
-  async execute(toolCallId, args) {
+  async execute(_toolCallId, args) {
     return withCredentialCheck("alpha_vantage", async () => {
       const apiKey = getConfig().alphaVantageApiKey!;
-      const result = await wrapProvider("alphavantage", () => getOverview(args.symbol.toUpperCase(), apiKey));
+      const result = await wrapProvider("alphavantage", () =>
+        getOverview(args.symbol.toUpperCase(), apiKey),
+      );
       if (result.status === "unavailable") {
         return {
-          content: [{ type: "text", text: `⚠ Company overview unavailable for ${args.symbol.toUpperCase()} (${result.reason}). Analysis will proceed without fundamentals.` }],
+          content: [
+            {
+              type: "text",
+              text: `⚠ Company overview unavailable for ${args.symbol.toUpperCase()} (${result.reason}). Analysis will proceed without fundamentals.`,
+            },
+          ],
           details: null as any,
         };
       }
@@ -31,11 +41,11 @@ export const companyOverviewTool: AgentTool<typeof params, CompanyOverview | { c
         `**${ov.name}** (${ov.symbol}) — ${ov.exchange}`,
         `Sector: ${ov.sector} | Industry: ${ov.industry}`,
         `Market Cap: $${formatLargeNumber(ov.marketCap)} | P/E: ${ov.pe ?? "N/A"} | Fwd P/E: ${ov.forwardPe ?? "N/A"}`,
-        `EPS: $${ov.eps ?? "N/A"} | Div Yield: ${ov.dividendYield ? (ov.dividendYield * 100).toFixed(2) + "%" : "N/A"}`,
-        `Beta: ${ov.beta ?? "N/A"} | Profit Margin: ${ov.profitMargin ? (ov.profitMargin * 100).toFixed(1) + "%" : "N/A"}`,
+        `EPS: $${ov.eps ?? "N/A"} | Div Yield: ${ov.dividendYield ? `${(ov.dividendYield * 100).toFixed(2)}%` : "N/A"}`,
+        `Beta: ${ov.beta ?? "N/A"} | Profit Margin: ${ov.profitMargin ? `${(ov.profitMargin * 100).toFixed(1)}%` : "N/A"}`,
         `52W: $${ov.week52Low.toFixed(2)} - $${ov.week52High.toFixed(2)}`,
         ``,
-        ov.description.slice(0, 300) + (ov.description.length > 300 ? "..." : ""),
+        `${ov.description.slice(0, 300)}${ov.description.length > 300 ? "..." : ""}`,
       ].join("\n");
 
       const prefix = result.stale

package/src/tools/fundamentals/comps.ts

@@ -1,9 +1,9 @@
-import { Type } from "@sinclair/typebox";
 import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { getOverview } from "../../providers/alpha-vantage.js";
-import { wrapProvider } from "../../providers/wrap-provider.js";
+import { Type } from "@sinclair/typebox";
 import { getConfig } from "../../config.js";
 import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
+import { getOverview } from "../../providers/alpha-vantage.js";
+import { wrapProvider } from "../../providers/wrap-provider.js";
 import type { CompanyOverview } from "../../types/fundamentals.js";
 
 export interface CompsMetric {
@@ -55,8 +55,12 @@ export function computeComps(companies: CompanyOverview[]): CompsResult {
     const p25 = computePercentile(sortedVals, 0.25);
     const p75 = computePercentile(sortedVals, 0.75);
 
-    const best = def.lowerIsBetter ? sorted[0]?.sym ?? "" : sorted[sorted.length - 1]?.sym ?? "";
-    const worst = def.lowerIsBetter ? sorted[sorted.length - 1]?.sym ?? "" : sorted[0]?.sym ?? "";
+    const best = def.lowerIsBetter
+      ? (sorted[0]?.sym ?? "")
+      : (sorted[sorted.length - 1]?.sym ?? "");
+    const worst = def.lowerIsBetter
+      ? (sorted[sorted.length - 1]?.sym ?? "")
+      : (sorted[0]?.sym ?? "");
 
     return { metric: def.name, values, median, p25, p75, best, worst };
   });
@@ -67,9 +71,7 @@ export function computeComps(companies: CompanyOverview[]): CompsResult {
 function computeMedian(sorted: number[]): number | null {
   if (sorted.length === 0) return null;
   const mid = Math.floor(sorted.length / 2);
-  return sorted.length % 2 === 0
-    ? (sorted[mid - 1] + sorted[mid]) / 2
-    : sorted[mid];
+  return sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
 }
 
 function computePercentile(sorted: number[], p: number): number | null {
@@ -96,61 +98,72 @@ export const compsTool: AgentTool<typeof params> = {
   description:
     "Compare 2-6 companies side-by-side on key valuation and financial metrics: P/E, Forward P/E, EPS, Profit Margin, Revenue Growth, Dividend Yield, Beta. Identifies the cheapest and most expensive on each metric.",
   parameters: params,
-  async execute(toolCallId, args) {
+  async execute(_toolCallId, args) {
     return withCredentialCheck("alpha_vantage", async () => {
-    const config = getConfig();
-    const symbols = args.symbols.map((s) => s.toUpperCase());
-
-    const results = await Promise.all(
-      symbols.map(async (s) => ({
-        symbol: s,
-        result: await wrapProvider("alphavantage", () => getOverview(s, config.alphaVantageApiKey!)),
-      })),
-    );
-
-    const companies: CompanyOverview[] = [];
-    const unavailableSymbols: string[] = [];
-
-    for (const { symbol: sym, result: r } of results) {
-      if (r.status === "ok") {
-        companies.push(r.data);
-      } else {
-        unavailableSymbols.push(sym);
+      const config = getConfig();
+      const symbols = args.symbols.map((s) => s.toUpperCase());
+
+      const results = await Promise.all(
+        symbols.map(async (s) => ({
+          symbol: s,
+          result: await wrapProvider("alphavantage", () =>
+            getOverview(s, config.alphaVantageApiKey!),
+          ),
+        })),
+      );
+
+      const companies: CompanyOverview[] = [];
+      const unavailableSymbols: string[] = [];
+
+      for (const { symbol: sym, result: r } of results) {
+        if (r.status === "ok") {
+          companies.push(r.data);
+        } else {
+          unavailableSymbols.push(sym);
+        }
       }
-    }
 
-    if (companies.length === 0) {
-      return {
-        content: [{ type: "text", text: `⚠ Company fundamentals unavailable for all symbols: ${symbols.join(", ")}. Alpha Vantage may be rate limited.` }],
-        details: null as any,
-      };
-    }
+      if (companies.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `⚠ Company fundamentals unavailable for all symbols: ${symbols.join(", ")}. Alpha Vantage may be rate limited.`,
+            },
+          ],
+          details: null as any,
+        };
+      }
 
-    const result = computeComps(companies);
-    result.unavailableSymbols = unavailableSymbols;
-
-    const availableSymbols = companies.map((company) => company.symbol);
-    const header = `**Comparable Company Analysis**: ${availableSymbols.join(" vs ")}`;
-    const rows = result.metrics.map((m) => {
-      const vals = availableSymbols.map((s) => {
-        const v = m.values[s];
-        if (v == null) return "N/A".padStart(10);
-        if (Math.abs(v) < 1) return `${(v * 100).toFixed(1)}%`.padStart(10);
-        return v.toFixed(2).padStart(10);
+      const result = computeComps(companies);
+      result.unavailableSymbols = unavailableSymbols;
+
+      const availableSymbols = companies.map((company) => company.symbol);
+      const header = `**Comparable Company Analysis**: ${availableSymbols.join(" vs ")}`;
+      const rows = result.metrics.map((m) => {
+        const vals = availableSymbols.map((s) => {
+          const v = m.values[s];
+          if (v == null) return "N/A".padStart(10);
+          if (Math.abs(v) < 1) return `${(v * 100).toFixed(1)}%`.padStart(10);
+          return v.toFixed(2).padStart(10);
+        });
+        const medStr =
+          m.median != null
+            ? Math.abs(m.median) < 1
+              ? `${(m.median * 100).toFixed(1)}%`
+              : m.median.toFixed(2)
+            : "N/A";
+        return `  ${m.metric.padEnd(16)} ${vals.join("")}  Med: ${medStr}  Best: ${m.best}`;
       });
-      const medStr = m.median != null
-        ? (Math.abs(m.median) < 1 ? `${(m.median * 100).toFixed(1)}%` : m.median.toFixed(2))
-        : "N/A";
-      return `  ${m.metric.padEnd(16)} ${vals.join("")}  Med: ${medStr}  Best: ${m.best}`;
-    });
 
-    const symHeader = `  ${"Metric".padEnd(16)} ${availableSymbols.map((s) => s.padStart(10)).join("")}`;
-    const noteLines = unavailableSymbols.length > 0
-      ? ["", `Unavailable fundamentals: ${unavailableSymbols.join(", ")}`]
-      : [];
-    const text = [header, "", symHeader, ...rows, ...noteLines].join("\n");
+      const symHeader = `  ${"Metric".padEnd(16)} ${availableSymbols.map((s) => s.padStart(10)).join("")}`;
+      const noteLines =
+        unavailableSymbols.length > 0
+          ? ["", `Unavailable fundamentals: ${unavailableSymbols.join(", ")}`]
+          : [];
+      const text = [header, "", symHeader, ...rows, ...noteLines].join("\n");
 
-    return { content: [{ type: "text", text }], details: result };
+      return { content: [{ type: "text", text }], details: result };
     });
   },
 };