opencandle 0.2.0 → 0.3.0

package/dist/sentiment/types.d.ts

@@ -0,0 +1,66 @@
+export declare const SENTIMENT_SOURCES: readonly ["twitter", "reddit", "web", "finnhub"];
+export type SentimentSource = (typeof SENTIMENT_SOURCES)[number];
+export interface SentinelEngagement {
+    score: number;
+    replies: number | null;
+    shares: number | null;
+    views: number | null;
+}
+export interface SentinelSentiment {
+    score: number;
+    confidence: number;
+    method: "keyword";
+    tickers: string[];
+}
+export interface SentinelRecord {
+    id: string;
+    source: SentimentSource;
+    sourceId: string;
+    query: string;
+    title: string | null;
+    text: string;
+    author: string | null;
+    url: string;
+    publishedAt: string | null;
+    fetchedAt: string;
+    engagement: SentinelEngagement;
+    sentiment: SentinelSentiment;
+    metadata: Record<string, unknown>;
+}
+export declare function isSentinelRecord(val: unknown): val is SentinelRecord;
+export interface SentimentAdapter {
+    source: SentimentSource;
+    fetch(query: string, options?: {
+        hours?: number;
+    }): Promise<SentinelRecord[]>;
+}
+export interface ScorerOptions {
+    /** Minimum confidence for a keyword score to be considered "high confidence" */
+    confidenceThreshold?: number;
+}
+export interface TrendBucket {
+    timestamp: string;
+    avgScore: number;
+    count: number;
+}
+export interface TrendResult {
+    source: SentimentSource | "aggregate";
+    sparkline: string;
+    avgScore: number;
+    count: number;
+    direction: "rising" | "falling" | "stable";
+    delta: number;
+}
+export interface DivergenceResult {
+    detected: boolean;
+    retailAvg: number | null;
+    newsAvg: number | null;
+    gap: number | null;
+    message: string;
+}
+export interface SentimentSummary {
+    fresh: SentinelRecord[];
+    trend: TrendResult[] | null;
+    divergence: DivergenceResult | null;
+    warnings: string[];
+}

package/dist/sentiment/types.js

@@ -0,0 +1,54 @@
+export const SENTIMENT_SOURCES = ["twitter", "reddit", "web", "finnhub"];
+export function isSentinelRecord(val) {
+    if (val === null || typeof val !== "object")
+        return false;
+    const r = val;
+    if (typeof r.id !== "string")
+        return false;
+    if (typeof r.source !== "string" || !SENTIMENT_SOURCES.includes(r.source))
+        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;
+    if (typeof r.text !== "string")
+        return false;
+    if (r.author !== null && typeof r.author !== "string")
+        return false;
+    if (typeof r.url !== "string")
+        return false;
+    if (r.publishedAt !== null && typeof r.publishedAt !== "string")
+        return false;
+    if (typeof r.fetchedAt !== "string")
+        return false;
+    const eng = r.engagement;
+    if (eng === null || typeof eng !== "object")
+        return false;
+    const e = eng;
+    if (typeof e.score !== "number")
+        return false;
+    if (e.replies !== null && typeof e.replies !== "number")
+        return false;
+    if (e.shares !== null && typeof e.shares !== "number")
+        return false;
+    if (e.views !== null && typeof e.views !== "number")
+        return false;
+    const sent = r.sentiment;
+    if (sent === null || typeof sent !== "object")
+        return false;
+    const s = sent;
+    if (typeof s.score !== "number" || s.score < -1 || s.score > 1)
+        return false;
+    if (typeof s.confidence !== "number" || s.confidence < 0 || s.confidence > 1)
+        return false;
+    if (s.method !== "keyword")
+        return false;
+    if (!Array.isArray(s.tickers))
+        return false;
+    if (r.metadata === null || typeof r.metadata !== "object")
+        return false;
+    return true;
+}
+//# sourceMappingURL=types.js.map

package/dist/sentiment/types.js.map

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

package/dist/system-prompt.js

@@ -16,7 +16,7 @@ You provide data-driven analysis for stocks, crypto, macro economics, and portfo
 - **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_reddit_discussions, get_twitter_sentiment — retail sentiment from Reddit and Twitter/X
+- **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
 - **User Interaction**: ask_user — ask clarification questions; trigger_twitter_login — open a browser for Twitter/X login
@@ -40,6 +40,14 @@ When analyzing a stock, follow these steps in order:
 - 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.
 
+## Handling skipped data sources
+Tool results may include a tagged line beginning with \`[OPENCANDLE_SKIPPED ...]\`, \`[OPENCANDLE_CREDENTIAL_REQUIRED ...]\`, or \`[OPENCANDLE_SOFT_DEGRADED ...]\`. These signal that a data source was either skipped at the user's request, not configured, or fell back to a keyless alternative (e.g. Brave → DuckDuckGo, Exa → keyless MCP). When you see one or more of these in your tool results:
+1. Continue the analysis using whatever other data you have. Do NOT apologize, do NOT treat it as an error, do NOT suggest the user fix something they already declined.
+2. At the end of your final answer, add a \`**Data gaps**\` section listing each affected provider as one bullet, quoting the \`remediation\` string verbatim (e.g. \`run /connect financials to unlock\`). Aggregate \`[OPENCANDLE_SKIPPED ...]\` and \`[OPENCANDLE_SOFT_DEGRADED ...]\` tags together — both are "you didn't get the keyed source" signals from the user's perspective.
+3. For \`[OPENCANDLE_SOFT_DEGRADED ...]\` tags, briefly name the fallback that was used so the user understands where the data actually came from (e.g. "Web search used DuckDuckGo instead of Brave").
+4. EXCEPTION: if the \`remediation\` string contains the literal text \`(silenced)\`, the user has explicitly asked not to be pestered about this provider. Still describe the omission but OMIT the \`/connect\` remediation text for that bullet. Something like "Finnhub news was omitted (silenced)" is enough.
+5. A \`[OPENCANDLE_CONNECTED ...]\` tag means a credential was JUST saved mid-turn. Acknowledge it briefly ("Alpha Vantage just connected") and tell the user to re-run the previous request to fetch the data. Pi does not currently support re-dispatching the original tool call automatically.
+
 ## When to Ask for Clarification
 Use the ask_user tool BEFORE proceeding when:
 - The request is broad or vague (e.g., "analyze the market" without specifying which asset or sector)

package/dist/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,aAAsB;IACtD,MAAM,aAAa,GAAG,aAAa;QACjC,CAAC,CAAC;;;;EAIJ,aAAa,EAAE;QACb,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqFP,aAAa;;;mNAGoM,CAAC;AACpN,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,aAAsB;IACtD,MAAM,aAAa,GAAG,aAAa;QACjC,CAAC,CAAC;;;;EAIJ,aAAa,EAAE;QACb,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6FP,aAAa;;;mNAGoM,CAAC;AACpN,CAAC"}

package/dist/tools/fundamentals/company-overview.d.ts

@@ -3,5 +3,7 @@ import type { CompanyOverview } from "../../types/fundamentals.js";
 declare const params: import("@sinclair/typebox").TObject<{
     symbol: import("@sinclair/typebox").TString;
 }>;
-export declare const companyOverviewTool: AgentTool<typeof params, CompanyOverview>;
+export declare const companyOverviewTool: AgentTool<typeof params, CompanyOverview | {
+    credentialRequired: unknown;
+}>;
 export {};

package/dist/tools/fundamentals/company-overview.js

@@ -2,41 +2,41 @@ import { Type } from "@sinclair/typebox";
 import { getOverview } from "../../providers/alpha-vantage.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 import { getConfig } from "../../config.js";
+import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
 const params = Type.Object({
     symbol: Type.String({ description: "Stock ticker symbol (e.g. AAPL, MSFT)" }),
 });
 export const companyOverviewTool = {
     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_API_KEY.",
+    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) {
-        const apiKey = getConfig().alphaVantageApiKey;
-        if (!apiKey) {
-            throw new Error("Alpha Vantage API key not configured. Set ALPHA_VANTAGE_API_KEY or add ~/.opencandle/config.json.");
-        }
-        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.` }],
-                details: null,
-            };
-        }
-        const ov = result.data;
-        const text = [
-            `**${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"}`,
-            `52W: $${ov.week52Low.toFixed(2)} - $${ov.week52High.toFixed(2)}`,
-            ``,
-            ov.description.slice(0, 300) + (ov.description.length > 300 ? "..." : ""),
-        ].join("\n");
-        const prefix = result.stale
-            ? `⚠ Using cached fundamentals from ${result.timestamp} (Alpha Vantage rate limited)\n`
-            : "";
-        return { content: [{ type: "text", text: prefix + text }], details: ov };
+        return withCredentialCheck("alpha_vantage", async () => {
+            const apiKey = getConfig().alphaVantageApiKey;
+            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.` }],
+                    details: null,
+                };
+            }
+            const ov = result.data;
+            const text = [
+                `**${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"}`,
+                `52W: $${ov.week52Low.toFixed(2)} - $${ov.week52High.toFixed(2)}`,
+                ``,
+                ov.description.slice(0, 300) + (ov.description.length > 300 ? "..." : ""),
+            ].join("\n");
+            const prefix = result.stale
+                ? `⚠ Using cached fundamentals from ${result.timestamp} (Alpha Vantage rate limited)\n`
+                : "";
+            return { content: [{ type: "text", text: prefix + text }], details: ov };
+        });
     },
 };
 function formatLargeNumber(n) {

package/dist/tools/fundamentals/company-overview.js.map

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

package/dist/tools/fundamentals/comps.js

@@ -2,6 +2,7 @@ import { Type } from "@sinclair/typebox";
 import { getOverview } from "../../providers/alpha-vantage.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 import { getConfig } from "../../config.js";
+import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
 const METRIC_DEFS = [
     { name: "P/E", extract: (c) => c.pe, lowerIsBetter: true },
     { name: "Forward P/E", extract: (c) => c.forwardPe, lowerIsBetter: true },
@@ -64,55 +65,54 @@ export const compsTool = {
     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) {
-        const config = getConfig();
-        if (!config.alphaVantageApiKey) {
-            throw new Error("Alpha Vantage API key not configured. Set ALPHA_VANTAGE_API_KEY or add ~/.opencandle/config.json.");
-        }
-        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 = [];
-        const unavailableSymbols = [];
-        for (const { symbol: sym, result: r } of results) {
-            if (r.status === "ok") {
-                companies.push(r.data);
+        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 = [];
+            const unavailableSymbols = [];
+            for (const { symbol: sym, result: r } of results) {
+                if (r.status === "ok") {
+                    companies.push(r.data);
+                }
+                else {
+                    unavailableSymbols.push(sym);
+                }
             }
-            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,
+                };
             }
-        }
-        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,
-            };
-        }
-        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");
+            return { content: [{ type: "text", text }], details: result };
         });
-        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 };
     },
 };
 //# sourceMappingURL=comps.js.map

package/dist/tools/fundamentals/comps.js.map

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

package/dist/tools/fundamentals/dcf.js

@@ -3,6 +3,7 @@ import { getOverview, getFinancials } from "../../providers/alpha-vantage.js";
 import { getQuote } from "../../providers/yahoo-finance.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 import { getConfig } from "../../config.js";
+import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
 export function computeDCF(params) {
     const { freeCashFlow, growthRate, discountRate, terminalGrowth, years, netDebt, sharesOutstanding } = params;
     // Project future cash flows (mid-year convention: discount at year-0.5)
@@ -97,91 +98,90 @@ export const dcfTool = {
     description: "Compute a Discounted Cash Flow (DCF) intrinsic value estimate for a stock. Uses free cash flow, growth projections, and a discount rate to estimate what the stock is worth. Returns intrinsic value per share, margin of safety vs current price, and a sensitivity table.",
     parameters: params,
     async execute(toolCallId, args) {
-        const symbol = args.symbol.toUpperCase();
-        const config = getConfig();
-        if (!config.alphaVantageApiKey) {
-            throw new Error("Alpha Vantage API key not configured. Set ALPHA_VANTAGE_API_KEY or add ~/.opencandle/config.json.");
-        }
-        const [overviewResult, financialsResult, quoteResult] = await Promise.all([
-            wrapProvider("alphavantage", () => getOverview(symbol, config.alphaVantageApiKey)),
-            wrapProvider("alphavantage", () => getFinancials(symbol, config.alphaVantageApiKey)),
-            wrapProvider("yahoo", () => getQuote(symbol)),
-        ]);
-        const missing = [];
-        if (overviewResult.status === "unavailable")
-            missing.push(`company overview (${overviewResult.reason})`);
-        if (financialsResult.status === "unavailable")
-            missing.push(`financial statements (${financialsResult.reason})`);
-        if (quoteResult.status === "unavailable")
-            missing.push(`stock quote (${quoteResult.reason})`);
-        if (financialsResult.status === "unavailable" || quoteResult.status === "unavailable") {
-            return {
-                content: [{ type: "text", text: `⚠ DCF valuation unavailable for ${symbol}. Missing: ${missing.join(", ")}. Both financials and current price are required.` }],
-                details: null,
-            };
-        }
-        const overview = overviewResult.status === "ok" ? overviewResult.data : null;
-        const financials = financialsResult.data;
-        const quote = quoteResult.data;
-        const latestFCF = financials[0]?.freeCashFlow ?? 0;
-        if (latestFCF <= 0) {
+        return withCredentialCheck("alpha_vantage", async () => {
+            const symbol = args.symbol.toUpperCase();
+            const config = getConfig();
+            const [overviewResult, financialsResult, quoteResult] = await Promise.all([
+                wrapProvider("alphavantage", () => getOverview(symbol, config.alphaVantageApiKey)),
+                wrapProvider("alphavantage", () => getFinancials(symbol, config.alphaVantageApiKey)),
+                wrapProvider("yahoo", () => getQuote(symbol)),
+            ]);
+            const missing = [];
+            if (overviewResult.status === "unavailable")
+                missing.push(`company overview (${overviewResult.reason})`);
+            if (financialsResult.status === "unavailable")
+                missing.push(`financial statements (${financialsResult.reason})`);
+            if (quoteResult.status === "unavailable")
+                missing.push(`stock quote (${quoteResult.reason})`);
+            if (financialsResult.status === "unavailable" || quoteResult.status === "unavailable") {
+                return {
+                    content: [{ type: "text", text: `⚠ DCF valuation unavailable for ${symbol}. Missing: ${missing.join(", ")}. Both financials and current price are required.` }],
+                    details: null,
+                };
+            }
+            const overview = overviewResult.status === "ok" ? overviewResult.data : null;
+            const financials = financialsResult.data;
+            const quote = quoteResult.data;
+            const latestFCF = financials[0]?.freeCashFlow ?? 0;
+            if (latestFCF <= 0) {
+                return {
+                    content: [{ type: "text", text: `${symbol} has negative or zero free cash flow ($${latestFCF.toLocaleString()}). DCF is not meaningful for companies without positive FCF.` }],
+                    details: null,
+                };
+            }
+            // Estimate growth from historical FCF if not provided
+            let growthRate = args.growth_rate ?? 0.10;
+            if (!args.growth_rate && financials.length >= 2) {
+                const olderFCF = financials[1]?.freeCashFlow;
+                if (olderFCF && olderFCF > 0) {
+                    growthRate = Math.max(0.02, Math.min(0.25, (latestFCF - olderFCF) / olderFCF));
+                }
+            }
+            const discountRate = args.discount_rate ?? 0.10;
+            const terminalGrowth = args.terminal_growth ?? 0.03;
+            const years = args.projection_years ?? 5;
+            const marketCap = overview?.marketCap ?? 0;
+            const sharesOutstanding = quote.price > 0 && marketCap > 0 ? marketCap / quote.price : 1;
+            const netDebt = financials[0] ? computeNetDebt(financials[0]) : 0;
+            const result = computeDCF({
+                freeCashFlow: latestFCF,
+                growthRate,
+                discountRate,
+                terminalGrowth,
+                years,
+                netDebt: Math.max(0, netDebt),
+                sharesOutstanding,
+            });
+            const marginOfSafety = (result.intrinsicValue - quote.price) / result.intrinsicValue;
+            const upside = (result.intrinsicValue - quote.price) / quote.price;
+            const lines = [
+                `**${symbol} DCF Valuation**`,
+                ``,
+                `Current Price: $${quote.price.toFixed(2)}`,
+                `Intrinsic Value: $${result.intrinsicValue.toFixed(2)}`,
+                `Margin of Safety: ${(marginOfSafety * 100).toFixed(1)}%`,
+                `Upside/Downside: ${upside >= 0 ? "+" : ""}${(upside * 100).toFixed(1)}%`,
+                ``,
+                `**Assumptions**`,
+                `Free Cash Flow: $${(latestFCF / 1e9).toFixed(2)}B`,
+                `Growth Rate: ${(growthRate * 100).toFixed(1)}%`,
+                `Discount Rate (WACC): ${(discountRate * 100).toFixed(1)}%`,
+                `Terminal Growth: ${(terminalGrowth * 100).toFixed(1)}%`,
+                `Projection: ${years} years`,
+                ``,
+                `**Projected Cash Flows**`,
+                ...result.projectedCashFlows.map((cf) => `  Year ${cf.year}: FCF $${(cf.fcf / 1e9).toFixed(2)}B → PV $${(cf.presentValue / 1e9).toFixed(2)}B`),
+                `  Terminal Value: $${(result.terminalValue / 1e9).toFixed(2)}B`,
+                `  Enterprise Value: $${(result.enterpriseValue / 1e9).toFixed(2)}B`,
+                ``,
+                `**Sensitivity Table** (Intrinsic Value at different Growth/Discount rates)`,
+                ...formatSensitivityTable(result.sensitivityTable),
+            ];
             return {
-                content: [{ type: "text", text: `${symbol} has negative or zero free cash flow ($${latestFCF.toLocaleString()}). DCF is not meaningful for companies without positive FCF.` }],
-                details: null,
+                content: [{ type: "text", text: lines.join("\n") }],
+                details: { ...result, currentPrice: quote.price, marginOfSafety, upside },
             };
-        }
-        // Estimate growth from historical FCF if not provided
-        let growthRate = args.growth_rate ?? 0.10;
-        if (!args.growth_rate && financials.length >= 2) {
-            const olderFCF = financials[1]?.freeCashFlow;
-            if (olderFCF && olderFCF > 0) {
-                growthRate = Math.max(0.02, Math.min(0.25, (latestFCF - olderFCF) / olderFCF));
-            }
-        }
-        const discountRate = args.discount_rate ?? 0.10;
-        const terminalGrowth = args.terminal_growth ?? 0.03;
-        const years = args.projection_years ?? 5;
-        const marketCap = overview?.marketCap ?? 0;
-        const sharesOutstanding = quote.price > 0 && marketCap > 0 ? marketCap / quote.price : 1;
-        const netDebt = financials[0] ? computeNetDebt(financials[0]) : 0;
-        const result = computeDCF({
-            freeCashFlow: latestFCF,
-            growthRate,
-            discountRate,
-            terminalGrowth,
-            years,
-            netDebt: Math.max(0, netDebt),
-            sharesOutstanding,
         });
-        const marginOfSafety = (result.intrinsicValue - quote.price) / result.intrinsicValue;
-        const upside = (result.intrinsicValue - quote.price) / quote.price;
-        const lines = [
-            `**${symbol} DCF Valuation**`,
-            ``,
-            `Current Price: $${quote.price.toFixed(2)}`,
-            `Intrinsic Value: $${result.intrinsicValue.toFixed(2)}`,
-            `Margin of Safety: ${(marginOfSafety * 100).toFixed(1)}%`,
-            `Upside/Downside: ${upside >= 0 ? "+" : ""}${(upside * 100).toFixed(1)}%`,
-            ``,
-            `**Assumptions**`,
-            `Free Cash Flow: $${(latestFCF / 1e9).toFixed(2)}B`,
-            `Growth Rate: ${(growthRate * 100).toFixed(1)}%`,
-            `Discount Rate (WACC): ${(discountRate * 100).toFixed(1)}%`,
-            `Terminal Growth: ${(terminalGrowth * 100).toFixed(1)}%`,
-            `Projection: ${years} years`,
-            ``,
-            `**Projected Cash Flows**`,
-            ...result.projectedCashFlows.map((cf) => `  Year ${cf.year}: FCF $${(cf.fcf / 1e9).toFixed(2)}B → PV $${(cf.presentValue / 1e9).toFixed(2)}B`),
-            `  Terminal Value: $${(result.terminalValue / 1e9).toFixed(2)}B`,
-            `  Enterprise Value: $${(result.enterpriseValue / 1e9).toFixed(2)}B`,
-            ``,
-            `**Sensitivity Table** (Intrinsic Value at different Growth/Discount rates)`,
-            ...formatSensitivityTable(result.sensitivityTable),
-        ];
-        return {
-            content: [{ type: "text", text: lines.join("\n") }],
-            details: { ...result, currentPrice: quote.price, marginOfSafety, upside },
-        };
     },
 };
 function formatSensitivityTable(table) {