opencandle 0.11.1 → 0.13.0

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";
@@ -11,6 +10,7 @@ export { fearGreedTool } from "./macro/fear-greed.js";
 export { fredDataTool } from "./macro/fred-data.js";
 export { cryptoHistoryTool } from "./market/crypto-history.js";
 export { cryptoPriceTool } from "./market/crypto-price.js";
+export { priceComparisonTool } from "./market/price-comparison.js";
 export { screenStocksTool } from "./market/screen-stocks.js";
 export { searchTickerTool } from "./market/search-ticker.js";
 export { stockHistoryTool } from "./market/stock-history.js";
@@ -34,4 +34,123 @@ 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<"1y" | "2y" | "6mo">[]>>;
+}>, 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<{
+    symbol: import("@sinclair/typebox").TString;
+    range: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"10y" | "1d" | "1mo" | "1y" | "2y" | "3mo" | "5d" | "5y" | "6mo" | "max" | "ytd">[]>>;
+    interval: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"15m" | "1d" | "1h" | "1m" | "1mo" | "1wk" | "5m">[]>>;
+}>, import("../types/market.js").OHLCV[] | import("./market/stock-history.js").StaleStockHistoryDetails> | import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
+    symbols: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    range: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"10y" | "1d" | "1mo" | "1y" | "2y" | "3mo" | "5d" | "5y" | "6mo" | "max" | "ytd">[]>;
+    interval: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"15m" | "1d" | "1h" | "1m" | "1mo" | "1wk" | "5m">[]>>;
+}>, import("./market/price-comparison.js").PriceComparisonDetails> | 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;
+}>, (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

@@ -9,6 +9,7 @@ import { fearGreedTool } from "./macro/fear-greed.js";
 import { fredDataTool } from "./macro/fred-data.js";
 import { cryptoHistoryTool } from "./market/crypto-history.js";
 import { cryptoPriceTool } from "./market/crypto-price.js";
+import { priceComparisonTool } from "./market/price-comparison.js";
 import { screenStocksTool } from "./market/screen-stocks.js";
 import { searchTickerTool } from "./market/search-ticker.js";
 import { stockHistoryTool } from "./market/stock-history.js";
@@ -41,6 +42,7 @@ export { fearGreedTool } from "./macro/fear-greed.js";
 export { fredDataTool } from "./macro/fred-data.js";
 export { cryptoHistoryTool } from "./market/crypto-history.js";
 export { cryptoPriceTool } from "./market/crypto-price.js";
+export { priceComparisonTool } from "./market/price-comparison.js";
 export { screenStocksTool } from "./market/screen-stocks.js";
 export { searchTickerTool } from "./market/search-ticker.js";
 export { stockHistoryTool } from "./market/stock-history.js";
@@ -67,6 +69,7 @@ export function getAllTools(options = {}) {
         searchTickerTool,
         stockQuoteTool,
         stockHistoryTool,
+        priceComparisonTool,
         screenStocksTool,
         cryptoPriceTool,
         cryptoHistoryTool,
@@ -98,4 +101,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.js

@@ -118,4 +118,3 @@ function caveatText() {
         "- Polymarket is a crypto-settled venue with platform and settlement risks distinct from regulated exchanges.",
     ].join("\n");
 }
-//# sourceMappingURL=event-probabilities.js.map

package/dist/tools/macro/fear-greed.d.ts

@@ -1,5 +1,5 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 import type { FearGreedData } from "../../types/sentiment.js";
 declare const params: import("@sinclair/typebox").TObject<{}>;
-export declare const fearGreedTool: AgentTool<typeof params, FearGreedData>;
+export declare const fearGreedTool: AgentTool<typeof params, FearGreedData | null>;
 export {};

package/dist/tools/macro/fear-greed.js

@@ -31,4 +31,3 @@ function buildGauge(value) {
     const bar = "█".repeat(pos) + "░".repeat(width - pos);
     return `[${bar}] ${value}/100`;
 }
-//# sourceMappingURL=fear-greed.js.map

package/dist/tools/macro/fred-data.d.ts

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

package/dist/tools/macro/fred-data.js

@@ -24,6 +24,8 @@ export const fredDataTool = {
     async execute(_toolCallId, args) {
         return withCredentialCheck("fred", async () => {
             const apiKey = getConfig().fredApiKey;
+            if (!apiKey)
+                throw new Error("FRED credential is missing.");
             const seriesId = args.series_id.toUpperCase();
             const limit = normalizeLimit(seriesId, args.limit);
             const result = await wrapProvider("fred", () => getSeries(seriesId, apiKey, limit));
@@ -77,4 +79,3 @@ function formatDerivedChange(series) {
     const pct = (latest.value / prior.value - 1) * 100;
     return `Derived YoY change: ${pct.toFixed(2)}% (${prior.date} to ${latest.date}).`;
 }
-//# sourceMappingURL=fred-data.js.map

package/dist/tools/market/crypto-history.js

@@ -55,4 +55,3 @@ function buildRiskLines(id, bars) {
         `Value at Risk (95%, daily): ${(metrics.var95 * 100).toFixed(2)}%`,
     ];
 }
-//# sourceMappingURL=crypto-history.js.map

package/dist/tools/market/crypto-price.d.ts

@@ -4,7 +4,7 @@ import type { CryptoPrice } from "../../types/market.js";
 declare const params: import("@sinclair/typebox").TObject<{
     id: import("@sinclair/typebox").TString;
 }>;
-export declare const cryptoPriceTool: AgentTool<typeof params, CryptoPrice & {
+export declare const cryptoPriceTool: AgentTool<typeof params, (CryptoPrice & {
     freshness: FreshnessStamp;
-}>;
+}) | null>;
 export {};

package/dist/tools/market/crypto-price.js

@@ -58,4 +58,3 @@ function formatLargeNumber(n) {
         return `${(n / 1e6).toFixed(2)}M`;
     return n.toLocaleString();
 }
-//# sourceMappingURL=crypto-price.js.map

package/dist/tools/market/price-comparison.d.ts

@@ -0,0 +1,30 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type FreshnessStamp } from "../../infra/freshness.js";
+import type { OHLCV } from "../../types/market.js";
+import { HISTORY_INTERVALS, HISTORY_RANGES } from "./stock-history.js";
+type HistoryRange = (typeof HISTORY_RANGES)[number];
+type HistoryInterval = (typeof HISTORY_INTERVALS)[number];
+export interface PriceComparisonSeries {
+    symbol: string;
+    bars: OHLCV[];
+    indexed: number[];
+    provider?: string;
+    providerTimestamp: string;
+    cached: boolean;
+    stale: boolean;
+}
+export interface PriceComparisonDetails {
+    range: HistoryRange;
+    interval: HistoryInterval;
+    baseDate: string;
+    series: PriceComparisonSeries[];
+    unavailableSymbols: string[];
+    freshness: FreshnessStamp;
+}
+declare const params: import("@sinclair/typebox").TObject<{
+    symbols: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    range: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"10y" | "1d" | "1mo" | "1y" | "2y" | "3mo" | "5d" | "5y" | "6mo" | "max" | "ytd">[]>;
+    interval: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"15m" | "1d" | "1h" | "1m" | "1mo" | "1wk" | "5m">[]>>;
+}>;
+export declare const priceComparisonTool: AgentTool<typeof params, PriceComparisonDetails>;
+export {};

package/dist/tools/market/price-comparison.js

@@ -0,0 +1,202 @@
+import { Type } from "@sinclair/typebox";
+import { buildFreshnessStamp, formatAsOfLine } from "../../infra/freshness.js";
+import { fetchHistoryWithFallback, HISTORY_INTERVALS, HISTORY_RANGES } from "./stock-history.js";
+const DATE_ALIGNED_INTERVALS = new Set(["1d", "1wk", "1mo"]);
+const params = Type.Object({
+    symbols: Type.Array(Type.String({ description: "Ticker symbol" }), {
+        minItems: 2,
+        maxItems: 6,
+        description: "Ticker symbols to compare",
+    }),
+    range: Type.Union(HISTORY_RANGES.map((range) => Type.Literal(range)), {
+        description: "History range",
+    }),
+    interval: Type.Optional(Type.Union(HISTORY_INTERVALS.map((interval) => Type.Literal(interval)), { description: "Data interval. Default: 1d" })),
+});
+export const priceComparisonTool = {
+    name: "get_price_comparison",
+    label: "Price Comparison",
+    description: "Get aligned indexed price history for multiple ticker symbols",
+    parameters: params,
+    async execute(_toolCallId, args) {
+        const symbols = args.symbols.map((symbol) => symbol.toUpperCase());
+        const interval = args.interval ?? "1d";
+        const fetched = await Promise.all(symbols.map(async (symbol) => ({
+            symbol,
+            result: await fetchHistoryWithFallback(symbol, args.range, interval),
+        })));
+        const available = fetched.flatMap(({ symbol, result }) => result.status === "ok" && result.data.length > 0
+            ? [
+                {
+                    symbol,
+                    bars: result.data,
+                    provider: result.provider,
+                    providerTimestamp: result.timestamp,
+                    cached: result.cached === true,
+                    stale: result.stale === true,
+                },
+            ]
+            : []);
+        let unavailableSymbols = fetched.flatMap(({ symbol, result }) => result.status === "unavailable" || result.data.length === 0 ? [symbol] : []);
+        if (available.length < 2) {
+            const freshness = buildFreshnessStamp({});
+            const unavailableText = unavailableSymbols.join(", ") || symbols.join(", ");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Price comparison unavailable: fewer than 2 series.`,
+                            `Unavailable symbols: ${unavailableText}`,
+                            formatAsOfLine(freshness),
+                        ].join("\n"),
+                    },
+                ],
+                details: {
+                    range: args.range,
+                    interval,
+                    baseDate: "",
+                    series: [],
+                    unavailableSymbols,
+                    freshness,
+                },
+            };
+        }
+        let survivingAvailable = available;
+        let commonKeys = intersectAlignmentKeys(survivingAvailable, interval);
+        while (survivingAvailable.length >= 2 && commonKeys.size > 0) {
+            const invalidBaselineSymbols = survivingAvailable.flatMap(({ symbol, bars }) => {
+                const baseClose = bars.find((bar) => {
+                    const key = alignmentKey(bar, interval);
+                    return key !== undefined && commonKeys.has(key);
+                })?.close;
+                return typeof baseClose !== "number" || !Number.isFinite(baseClose) || baseClose <= 0
+                    ? [symbol]
+                    : [];
+            });
+            if (invalidBaselineSymbols.length === 0)
+                break;
+            unavailableSymbols = [...new Set([...unavailableSymbols, ...invalidBaselineSymbols])];
+            const invalid = new Set(invalidBaselineSymbols);
+            survivingAvailable = survivingAvailable.filter(({ symbol }) => !invalid.has(symbol));
+            commonKeys = intersectAlignmentKeys(survivingAvailable, interval);
+        }
+        if (survivingAvailable.length < 2) {
+            return unavailableComparison(args.range, interval, unavailableSymbols);
+        }
+        if (commonKeys.size === 0) {
+            unavailableSymbols = [
+                ...new Set([...unavailableSymbols, ...survivingAvailable.map(({ symbol }) => symbol)]),
+            ];
+            return unavailableComparison(args.range, interval, unavailableSymbols);
+        }
+        const series = survivingAvailable.map(({ symbol, bars, provider, providerTimestamp, cached, stale }) => {
+            const alignedBars = bars.filter((bar) => {
+                const key = alignmentKey(bar, interval);
+                return key !== undefined && commonKeys.has(key);
+            });
+            const baseClose = alignedBars[0].close;
+            return {
+                symbol,
+                bars: alignedBars,
+                indexed: alignedBars.map((bar) => (bar.close / baseClose) * 100),
+                provider,
+                providerTimestamp,
+                cached,
+                stale,
+            };
+        });
+        const baseDate = series[0]?.bars[0]?.date ?? "";
+        const latestDate = series[0]?.bars.at(-1)?.date;
+        const staleSeries = series.filter((item) => item.stale);
+        const freshness = buildFreshnessStamp({
+            asOf: latestDate,
+            cached: series.some((item) => item.cached),
+            stale: staleSeries.length > 0,
+            cachedAt: staleSeries.map((item) => item.providerTimestamp).sort()[0],
+        });
+        const rows = series.map(({ symbol, bars, indexed }) => {
+            const first = bars[0]?.close ?? 0;
+            const last = bars.at(-1)?.close ?? 0;
+            const change = (indexed.at(-1) ?? 100) - 100;
+            return `${symbol} | ${first.toFixed(2)} | ${last.toFixed(2)} | ${change.toFixed(2)}%`;
+        });
+        const alignmentLosses = survivingAvailable.flatMap(({ symbol, bars }) => {
+            const dropped = bars.length - commonKeys.size;
+            return dropped / bars.length > 0.3
+                ? [`${symbol} (${dropped}/${bars.length} dates dropped)`]
+                : [];
+        });
+        const alignmentLine = alignmentLosses.length > 0 ? [`Reduced aligned window: ${alignmentLosses.join(", ")}`] : [];
+        const unavailableLine = unavailableSymbols.length > 0
+            ? [`Unavailable symbols: ${unavailableSymbols.join(", ")}`]
+            : [];
+        const staleLine = staleSeries.length > 0
+            ? [
+                `Stale series: ${staleSeries
+                    .map((item) => `${item.symbol} (${item.provider ?? "unknown provider"})`)
+                    .join(", ")}`,
+            ]
+            : [];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        ...rows,
+                        ...alignmentLine,
+                        ...unavailableLine,
+                        ...staleLine,
+                        formatAsOfLine(freshness),
+                    ].join("\n"),
+                },
+            ],
+            details: {
+                range: args.range,
+                interval,
+                baseDate,
+                series,
+                unavailableSymbols,
+                freshness,
+            },
+        };
+    },
+};
+function intersectAlignmentKeys(series, interval) {
+    const commonKeys = new Set(series[0]?.bars.flatMap((bar) => {
+        const key = alignmentKey(bar, interval);
+        return key === undefined ? [] : [key];
+    }) ?? []);
+    for (const candidate of series.slice(1)) {
+        const candidateKeys = new Set(candidate.bars.flatMap((bar) => {
+            const key = alignmentKey(bar, interval);
+            return key === undefined ? [] : [key];
+        }));
+        for (const key of commonKeys) {
+            if (!candidateKeys.has(key))
+                commonKeys.delete(key);
+        }
+    }
+    return commonKeys;
+}
+function alignmentKey(bar, interval) {
+    if (DATE_ALIGNED_INTERVALS.has(interval))
+        return bar.date;
+    return Number.isFinite(bar.timestamp) ? bar.timestamp : undefined;
+}
+function unavailableComparison(range, interval, unavailableSymbols) {
+    const freshness = buildFreshnessStamp({});
+    return {
+        content: [
+            {
+                type: "text",
+                text: [
+                    "Price comparison unavailable: fewer than 2 usable aligned series.",
+                    `Unavailable symbols: ${unavailableSymbols.join(", ")}`,
+                    formatAsOfLine(freshness),
+                ].join("\n"),
+            },
+        ],
+        details: { range, interval, baseDate: "", series: [], unavailableSymbols, freshness },
+    };
+}

package/dist/tools/market/screen-stocks.js

@@ -260,4 +260,3 @@ function formatValue(value) {
         return value.join(", ");
     return String(value);
 }
-//# sourceMappingURL=screen-stocks.js.map

package/dist/tools/market/search-ticker.js

@@ -174,7 +174,7 @@ function normalizeTickerQuery(query) {
     return /^[A-Z0-9][A-Z0-9.-]{0,9}$/.test(normalized) ? normalized : undefined;
 }
 function symbolFromTvSymbol(tvSymbol) {
-    return tvSymbol.includes(":") ? tvSymbol.split(":").at(-1) : tvSymbol;
+    return tvSymbol.includes(":") ? (tvSymbol.split(":").at(-1) ?? tvSymbol) : tvSymbol;
 }
 function exchangeFromTvSymbol(tvSymbol) {
     return tvSymbol.includes(":") ? tvSymbol.split(":")[0] : "";
@@ -182,4 +182,3 @@ function exchangeFromTvSymbol(tvSymbol) {
 function stringValue(value) {
     return typeof value === "string" ? value : undefined;
 }
-//# sourceMappingURL=search-ticker.js.map

package/dist/tools/market/stock-history.d.ts

@@ -1,9 +1,24 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type FreshnessStamp } from "../../infra/freshness.js";
+import type { ProviderResult } from "../../runtime/evidence.js";
 import type { OHLCV } from "../../types/market.js";
+export declare const HISTORY_RANGES: readonly ["1d", "5d", "1mo", "3mo", "6mo", "ytd", "1y", "2y", "5y", "10y", "max"];
+export declare const HISTORY_INTERVALS: readonly ["1m", "5m", "15m", "1h", "1d", "1wk", "1mo"];
+export declare function hasIntradayHistoryFallback(interval: (typeof HISTORY_INTERVALS)[number]): boolean;
+export declare function fetchHistoryWithFallback(symbol: string, range: (typeof HISTORY_RANGES)[number], interval: (typeof HISTORY_INTERVALS)[number]): Promise<ProviderResult<OHLCV[]>>;
+type HistoryRange = (typeof HISTORY_RANGES)[number];
+export declare function historyRangeToStart(range: HistoryRange, now?: Date): string | undefined;
 declare const params: 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">[]>>;
+    range: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"10y" | "1d" | "1mo" | "1y" | "2y" | "3mo" | "5d" | "5y" | "6mo" | "max" | "ytd">[]>>;
+    interval: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"15m" | "1d" | "1h" | "1m" | "1mo" | "1wk" | "5m">[]>>;
 }>;
-export declare const stockHistoryTool: AgentTool<typeof params, OHLCV[]>;
+export interface StaleStockHistoryDetails {
+    bars: OHLCV[];
+    provider?: string;
+    providerTimestamp: string;
+    stale: true;
+    freshness: FreshnessStamp;
+}
+export declare const stockHistoryTool: AgentTool<typeof params, OHLCV[] | StaleStockHistoryDetails>;
 export {};