opencandle 0.11.0 → 0.12.0

package/dist/tools/fundamentals/dcf.js

@@ -1,9 +1,9 @@
 import { Type } from "@sinclair/typebox";
 import { getConfig } from "../../config.js";
-import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
 import { getFinancials, getOverview } from "../../providers/alpha-vantage.js";
+import { ProviderCredentialError } from "../../providers/provider-credential-error.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
-import { getQuote } from "../../providers/yahoo-finance.js";
+import { getQuote, getYahooFinancials } from "../../providers/yahoo-finance.js";
 export function computeDCF(params) {
     const { freeCashFlow, growthRate, discountRate, terminalGrowth, years, netDebt, sharesOutstanding, } = params;
     // Gordon Growth requires discount > terminal growth; a non-positive spread
@@ -89,6 +89,28 @@ export function computeNetDebt(f) {
     }
     return null;
 }
+async function optionalAlphaVantage(apiKey, fn) {
+    if (!apiKey) {
+        return {
+            status: "unavailable",
+            reason: "Alpha Vantage API key not configured",
+            provider: "alphavantage",
+        };
+    }
+    try {
+        return await wrapProvider("alphavantage", () => fn(apiKey));
+    }
+    catch (error) {
+        if (error instanceof ProviderCredentialError) {
+            return {
+                status: "unavailable",
+                reason: `Alpha Vantage credential ${error.reason}`,
+                provider: "alphavantage",
+            };
+        }
+        throw error;
+    }
+}
 const params = Type.Object({
     symbol: Type.String({ description: "Stock ticker symbol (e.g. AAPL, MSFT)" }),
     growth_rate: Type.Optional(Type.Number({
@@ -104,139 +126,188 @@ 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) {
-        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) {
+        const symbol = args.symbol.toUpperCase();
+        const config = getConfig();
+        const alphaVantageApiKey = config.alphaVantageApiKey;
+        const [alphaVantageFinancialsResult, quoteResult] = await Promise.all([
+            optionalAlphaVantage(alphaVantageApiKey, (apiKey) => getFinancials(symbol, apiKey)),
+            wrapProvider("yahoo", () => getQuote(symbol)),
+        ]);
+        const missing = [];
+        if (quoteResult.status === "unavailable")
+            missing.push(`stock quote (${quoteResult.reason})`);
+        if (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 quote = quoteResult.data;
+        if (quote.price <= 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `⚠ DCF valuation unavailable for ${symbol}. Missing: current stock price. DCF output requires a real current quote price.`,
+                    },
+                ],
+                details: null,
+            };
+        }
+        let financialsSource = "Alpha Vantage";
+        let financials;
+        if (alphaVantageFinancialsResult.status === "ok" && !alphaVantageFinancialsResult.stale) {
+            financials = alphaVantageFinancialsResult.data;
+        }
+        else {
+            const alphaVantageReason = alphaVantageFinancialsResult.status === "ok"
+                ? `stale cached financial statements${alphaVantageFinancialsResult.timestamp
+                    ? ` from ${alphaVantageFinancialsResult.timestamp}`
+                    : ""}`
+                : alphaVantageFinancialsResult.reason;
+            const yahooFinancialsResult = await wrapProvider("yahoo", () => getYahooFinancials(symbol));
+            if (yahooFinancialsResult.status === "unavailable") {
                 return {
                     content: [
                         {
                             type: "text",
-                            text: `${symbol} has negative or zero free cash flow ($${latestFCF.toLocaleString()}). DCF is not meaningful for companies without positive FCF.`,
+                            text: `⚠ DCF valuation unavailable for ${symbol}. Missing: financial statements (Alpha Vantage: ${alphaVantageReason}; Yahoo Finance: ${yahooFinancialsResult.reason}). Both financials and current price are required.`,
                         },
                     ],
                     details: null,
                 };
             }
-            // Estimate growth from historical FCF if not provided
-            let growthRate = args.growth_rate ?? 0.1;
-            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.1;
-            const terminalGrowth = args.terminal_growth ?? 0.03;
-            if (discountRate <= terminalGrowth) {
+            if (yahooFinancialsResult.stale) {
+                const cachedAt = yahooFinancialsResult.timestamp
+                    ? ` from ${yahooFinancialsResult.timestamp}`
+                    : "";
                 return {
                     content: [
                         {
                             type: "text",
-                            text: `⚠ Invalid DCF assumptions for ${symbol}: terminal growth (${(terminalGrowth * 100).toFixed(1)}%) must be below the discount rate (${(discountRate * 100).toFixed(1)}%) for the Gordon Growth terminal value to be meaningful. Lower terminal_growth or raise discount_rate.`,
+                            text: `⚠ DCF valuation unavailable for ${symbol}. Yahoo Finance returned stale cached financial statements${cachedAt} after Alpha Vantage could not provide fresh financial statements (${alphaVantageReason}). DCF output requires fresh financial statements and a current price.`,
                         },
                     ],
                     details: null,
                 };
             }
-            const years = args.projection_years ?? 5;
-            // Prefer the overview market cap; fall back to the quote's market cap.
-            // Never substitute a placeholder share count — a fabricated
-            // per-share value is worse than an honest refusal.
-            const marketCap = overview?.marketCap && overview.marketCap > 0
-                ? overview.marketCap
-                : quote.marketCap > 0
-                    ? quote.marketCap
-                    : 0;
-            if (quote.price <= 0 || marketCap <= 0) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `⚠ Cannot compute a per-share DCF for ${symbol}: shares outstanding cannot be derived because ${quote.price <= 0 ? "the current quote price is unavailable" : "market capitalization is unavailable from the overview and quote providers"}. Per-share intrinsic value requires a real share count.`,
-                        },
-                    ],
-                    details: null,
-                };
+            financials = yahooFinancialsResult.data;
+            financialsSource = "Yahoo Finance";
+        }
+        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.1;
+        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 sharesOutstanding = marketCap / quote.price;
-            // Signed on purpose: net cash (negative net debt) adds to equity value.
-            // Omit the adjustment if debt/cash fields are missing; assets minus
-            // liabilities is book equity, not a net-cash proxy.
-            const computedNetDebt = financials[0] ? computeNetDebt(financials[0]) : null;
-            const netDebt = computedNetDebt ?? 0;
-            const result = computeDCF({
-                freeCashFlow: latestFCF,
-                growthRate,
-                discountRate,
-                terminalGrowth,
-                years,
-                netDebt,
-                sharesOutstanding,
-            });
-            if (computedNetDebt == null) {
-                result.warnings.push("Net debt adjustment omitted because total debt and cash equivalents were unavailable.");
+        }
+        const discountRate = args.discount_rate ?? 0.1;
+        const terminalGrowth = args.terminal_growth ?? 0.03;
+        if (discountRate <= terminalGrowth) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `⚠ Invalid DCF assumptions for ${symbol}: terminal growth (${(terminalGrowth * 100).toFixed(1)}%) must be below the discount rate (${(discountRate * 100).toFixed(1)}%) for the Gordon Growth terminal value to be meaningful. Lower terminal_growth or raise discount_rate.`,
+                    },
+                ],
+                details: null,
+            };
+        }
+        const years = args.projection_years ?? 5;
+        // Prefer an actual reported share count, then derive from market cap
+        // only when needed. Never substitute a placeholder share count.
+        const statementSharesOutstanding = financials[0]?.sharesOutstanding;
+        let marketCap = quote.marketCap > 0 ? quote.marketCap : 0;
+        let sharesOutstanding = statementSharesOutstanding && statementSharesOutstanding > 0 ? statementSharesOutstanding : 0;
+        if (sharesOutstanding <= 0 && marketCap <= 0) {
+            const overviewResult = await optionalAlphaVantage(alphaVantageApiKey, (apiKey) => getOverview(symbol, apiKey));
+            if (overviewResult.status === "ok" && overviewResult.data.marketCap > 0) {
+                marketCap = overviewResult.data.marketCap;
             }
-            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),
-                ...(result.warnings.length > 0
-                    ? ["", "**Warnings**", ...result.warnings.map((warning) => `- ${warning}`)]
-                    : []),
-            ];
+        }
+        if (sharesOutstanding <= 0 && quote.price > 0 && marketCap > 0) {
+            sharesOutstanding = marketCap / quote.price;
+        }
+        if (sharesOutstanding <= 0) {
             return {
-                content: [{ type: "text", text: lines.join("\n") }],
-                details: { ...result, currentPrice: quote.price, marginOfSafety, upside },
+                content: [
+                    {
+                        type: "text",
+                        text: `⚠ Cannot compute a per-share DCF for ${symbol}: shares outstanding are unavailable from financial statements and cannot be derived because ${quote.price <= 0 ? "the current quote price is unavailable" : "market capitalization is unavailable from the overview and quote providers"}. Per-share intrinsic value requires a real share count.`,
+                    },
+                ],
+                details: null,
             };
+        }
+        // Signed on purpose: net cash (negative net debt) adds to equity value.
+        // Omit the adjustment if debt/cash fields are missing; assets minus
+        // liabilities is book equity, not a net-cash proxy.
+        const computedNetDebt = financials[0] ? computeNetDebt(financials[0]) : null;
+        const netDebt = computedNetDebt ?? 0;
+        const result = computeDCF({
+            freeCashFlow: latestFCF,
+            growthRate,
+            discountRate,
+            terminalGrowth,
+            years,
+            netDebt,
+            sharesOutstanding,
         });
+        if (computedNetDebt == null) {
+            result.warnings.push("Net debt adjustment omitted because total debt and cash equivalents were unavailable.");
+        }
+        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**`,
+            `Financial statements source: ${financialsSource}`,
+            `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),
+            ...(result.warnings.length > 0
+                ? ["", "**Warnings**", ...result.warnings.map((warning) => `- ${warning}`)]
+                : []),
+        ];
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            details: { ...result, currentPrice: quote.price, marginOfSafety, upside },
+        };
     },
 };
 function formatSensitivityTable(table) {
@@ -254,4 +325,3 @@ function formatSensitivityTable(table) {
     });
     return [header, ...rows];
 }
-//# sourceMappingURL=dcf.js.map

package/dist/tools/fundamentals/earnings.d.ts

@@ -5,5 +5,5 @@ declare const params: import("@sinclair/typebox").TObject<{
 }>;
 export declare const earningsTool: AgentTool<typeof params, EarningsData | {
     credentialRequired: unknown;
-}>;
+} | null>;
 export {};

package/dist/tools/fundamentals/earnings.js

@@ -14,6 +14,8 @@ export const earningsTool = {
     async execute(_toolCallId, args) {
         return withCredentialCheck("alpha_vantage", async () => {
             const apiKey = getConfig().alphaVantageApiKey;
+            if (!apiKey)
+                throw new Error("Alpha Vantage credential is missing.");
             const result = await wrapProvider("alphavantage", () => getEarnings(args.symbol.toUpperCase(), apiKey));
             if (result.status === "unavailable") {
                 return {
@@ -43,4 +45,3 @@ export const earningsTool = {
         });
     },
 };
-//# sourceMappingURL=earnings.js.map

package/dist/tools/fundamentals/financials.js

@@ -14,6 +14,8 @@ export const financialsTool = {
     async execute(_toolCallId, args) {
         return withCredentialCheck("alpha_vantage", async () => {
             const apiKey = getConfig().alphaVantageApiKey;
+            if (!apiKey)
+                throw new Error("Alpha Vantage credential is missing.");
             const result = await wrapProvider("alphavantage", () => getFinancials(args.symbol.toUpperCase(), apiKey));
             if (result.status === "unavailable") {
                 return {
@@ -47,4 +49,3 @@ function fmt(n) {
         return `${(n / 1e6).toFixed(2)}M`;
     return n.toLocaleString();
 }
-//# sourceMappingURL=financials.js.map

package/dist/tools/fundamentals/sec-filings.js

@@ -77,4 +77,3 @@ export const secFilingsTool = {
         };
     },
 };
-//# sourceMappingURL=sec-filings.js.map

package/dist/tools/index.d.ts

@@ -1,4 +1,3 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
 import type { AskUserHandler } from "../types/index.js";
 export { companyOverviewTool } from "./fundamentals/company-overview.js";
 export { compsTool } from "./fundamentals/comps.js";
@@ -6,6 +5,7 @@ export { dcfTool } from "./fundamentals/dcf.js";
 export { earningsTool } from "./fundamentals/earnings.js";
 export { financialsTool } from "./fundamentals/financials.js";
 export { secFilingsTool } from "./fundamentals/sec-filings.js";
+export { eventProbabilitiesTool } from "./macro/event-probabilities.js";
 export { fearGreedTool } from "./macro/fear-greed.js";
 export { fredDataTool } from "./macro/fred-data.js";
 export { cryptoHistoryTool } from "./market/crypto-history.js";
@@ -33,4 +33,119 @@ export { backtestTool } from "./technical/backtest.js";
 export { technicalIndicatorsTool } from "./technical/indicators.js";
 export declare function getAllTools(options?: {
     askUserHandler?: AskUserHandler;
-}): AgentTool<any>[];
+}): (import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+}>, import("../types/fundamentals.js").CompanyOverview | {
+    credentialRequired: unknown;
+} | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbols: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    growth_rate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    discount_rate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    terminal_growth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    projection_years: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+}>, import("../types/fundamentals.js").EarningsData | {
+    credentialRequired: unknown;
+} | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+}>, import("../types/fundamentals.js").FinancialStatement[] | {
+    credentialRequired: unknown;
+}> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    form_types: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    include_snippets: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{}>, import("../types/sentiment.js").FearGreedData | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    series_id: import("@sinclair/typebox").TString;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+}>, import("../types/macro.js").FredSeries | {
+    credentialRequired: unknown;
+} | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"6mo" | "1y" | "2y">[]>>;
+}>, import("../types/portfolio.js").RiskMetrics | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    days: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, import("../types/market.js").OHLCV[]> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+}>, (import("../types/market.js").CryptoPrice & {
+    freshness: import("../infra/freshness.js").FreshnessStamp;
+}) | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    market: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    columns: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    filter: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        field: import("@sinclair/typebox").TString;
+        op: import("@sinclair/typebox").TString;
+        value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    }>>>;
+    sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        field: import("@sinclair/typebox").TString;
+        direction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, import("../providers/tradingview.js").ScreenerRow[]> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    range: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"6mo" | "1d" | "ytd" | "5d" | "1mo" | "3mo" | "1y" | "2y" | "5y" | "10y" | "max">[]>>;
+    interval: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"1d" | "1mo" | "1wk" | "1m" | "5m" | "15m" | "1h">[]>>;
+}>, import("../types/market.js").OHLCV[]> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+}>, (import("../types/market.js").StockQuote & {
+    freshness: import("../infra/freshness.js").FreshnessStamp;
+}) | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    expiration: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"call">, import("@sinclair/typebox").TLiteral<"put">, import("@sinclair/typebox").TLiteral<"CALL">, import("@sinclair/typebox").TLiteral<"PUT">]>>;
+}>, (import("../types/options.js").OptionsChain & {
+    freshness: import("../infra/freshness.js").FreshnessStamp;
+}) | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    range: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create_price_above">, import("@sinclair/typebox").TLiteral<"create_price_below">, import("@sinclair/typebox").TLiteral<"create_price_above_sma">, import("@sinclair/typebox").TLiteral<"create_price_below_sma">, import("@sinclair/typebox").TLiteral<"create_rsi_above">, import("@sinclair/typebox").TLiteral<"create_rsi_below">, import("@sinclair/typebox").TLiteral<"create_volume_spike">, import("@sinclair/typebox").TLiteral<"create_percent_move_up">, import("@sinclair/typebox").TLiteral<"create_percent_move_down">, import("@sinclair/typebox").TLiteral<"create_sma_cross_above">, import("@sinclair/typebox").TLiteral<"create_sma_cross_below">, import("@sinclair/typebox").TLiteral<"set_enabled">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"status">, import("@sinclair/typebox").TLiteral<"check">]>;
+    symbol: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    threshold: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    fast_period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    slow_period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    cooldown_seconds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    condition_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create_price_above">, import("@sinclair/typebox").TLiteral<"create_price_below">, import("@sinclair/typebox").TLiteral<"create_price_above_sma">, import("@sinclair/typebox").TLiteral<"create_price_below_sma">, import("@sinclair/typebox").TLiteral<"create_rsi_above">, import("@sinclair/typebox").TLiteral<"create_rsi_below">, import("@sinclair/typebox").TLiteral<"create_volume_spike">, import("@sinclair/typebox").TLiteral<"create_percent_move_up">, import("@sinclair/typebox").TLiteral<"create_percent_move_down">, import("@sinclair/typebox").TLiteral<"create_sma_cross_above">, import("@sinclair/typebox").TLiteral<"create_sma_cross_below">]>>;
+    enabled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    check_after_create: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"configure">, import("@sinclair/typebox").TLiteral<"history">]>;
+    timezone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    local_time: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"acknowledge">]>;
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"rename">, import("@sinclair/typebox").TLiteral<"add">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"remove">, import("@sinclair/typebox").TLiteral<"view">]>;
+    portfolio_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    new_portfolio_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    lot_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    symbol: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    shares: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    avg_cost: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    currency: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"rename">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"add">, import("@sinclair/typebox").TLiteral<"remove">, import("@sinclair/typebox").TLiteral<"check">]>;
+    watchlist_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    symbol: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    new_watchlist_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, any> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    subreddit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    query: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    subreddits: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, import("../types/sentiment.js").RedditSentimentResult | null> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbol: import("@sinclair/typebox").TString;
+    strategy: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"sma_crossover">, import("@sinclair/typebox").TLiteral<"sma_50_200_crossover">, import("@sinclair/typebox").TLiteral<"rsi_mean_reversion">]>;
+    period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"1y">, import("@sinclair/typebox").TLiteral<"2y">, import("@sinclair/typebox").TLiteral<"5y">]>>;
+    cost_bps: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>)[];

package/dist/tools/index.js

@@ -4,6 +4,7 @@ import { dcfTool } from "./fundamentals/dcf.js";
 import { earningsTool } from "./fundamentals/earnings.js";
 import { financialsTool } from "./fundamentals/financials.js";
 import { secFilingsTool } from "./fundamentals/sec-filings.js";
+import { eventProbabilitiesTool } from "./macro/event-probabilities.js";
 import { fearGreedTool } from "./macro/fear-greed.js";
 import { fredDataTool } from "./macro/fred-data.js";
 import { cryptoHistoryTool } from "./market/crypto-history.js";
@@ -35,6 +36,7 @@ export { dcfTool } from "./fundamentals/dcf.js";
 export { earningsTool } from "./fundamentals/earnings.js";
 export { financialsTool } from "./fundamentals/financials.js";
 export { secFilingsTool } from "./fundamentals/sec-filings.js";
+export { eventProbabilitiesTool } from "./macro/event-probabilities.js";
 export { fearGreedTool } from "./macro/fear-greed.js";
 export { fredDataTool } from "./macro/fred-data.js";
 export { cryptoHistoryTool } from "./market/crypto-history.js";
@@ -74,6 +76,7 @@ export function getAllTools(options = {}) {
         dcfTool,
         compsTool,
         secFilingsTool,
+        eventProbabilitiesTool,
         fredDataTool,
         fearGreedTool,
         createRedditSentimentTool({ askUserHandler: options.askUserHandler }),
@@ -95,4 +98,3 @@ export function getAllTools(options = {}) {
         createSentimentSummaryTool({ askUserHandler: options.askUserHandler }),
     ];
 }
-//# sourceMappingURL=index.js.map

package/dist/tools/interaction/ask-user.js

@@ -32,6 +32,17 @@ export function registerAskUserTool(pi, askUserHandler) {
                     details: { question, questionType, answer: null, cancelled: true },
                 };
             }
+            if (!ctx && !askUserHandler) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "UI not available (non-interactive mode). Proceed with your best judgment and clearly disclose your assumption.",
+                        },
+                    ],
+                    details: { question, questionType, answer: null, cancelled: true },
+                };
+            }
             const result = await promptUser(ctx, {
                 question,
                 questionType,
@@ -60,4 +71,3 @@ export function registerAskUserTool(pi, askUserHandler) {
         },
     });
 }
-//# sourceMappingURL=ask-user.js.map

package/dist/tools/macro/event-probabilities.d.ts

@@ -0,0 +1,8 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { PredictionMarketQuote } from "../../types/prediction-markets.js";
+declare const params: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+}>;
+export declare const eventProbabilitiesTool: AgentTool<typeof params, PredictionMarketQuote[]>;
+export {};