opencandle 0.11.1 → 0.12.0

package/src/tools/market/screen-stocks.ts

@@ -1,290 +0,0 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { type Static, Type } from "@sinclair/typebox";
-import { buildFreshnessStamp, formatAsOfLine } from "../../infra/freshness.js";
-import type { ScreenerRow, ScreenFilterOp } from "../../providers/tradingview.js";
-import { screenStocks } from "../../providers/tradingview.js";
-import { wrapProvider } from "../../providers/wrap-provider.js";
-
-const filterOps = [
-  "greater",
-  "GREATER",
-  "gt",
-  "GT",
-  ">",
-  "egreater",
-  "EGREATER",
-  "gte",
-  "GTE",
-  ">=",
-  "less",
-  "LESS",
-  "lt",
-  "LT",
-  "<",
-  "eless",
-  "ELESS",
-  "lte",
-  "LTE",
-  "<=",
-  "equal",
-  "EQUAL",
-  "eq",
-  "EQ",
-  "==",
-  "nequal",
-  "NEQUAL",
-  "neq",
-  "NEQ",
-  "!=",
-  "in_range",
-  "IN_RANGE",
-  "not_in_range",
-  "NOT_IN_RANGE",
-  "crosses",
-  "CROSSES",
-  "crosses_above",
-  "CROSSES_ABOVE",
-  "crosses_below",
-  "CROSSES_BELOW",
-  "above%",
-  "ABOVE%",
-  "below%",
-  "BELOW%",
-  "match",
-  "MATCH",
-  "nmatch",
-  "NMATCH",
-  "has",
-  "HAS",
-  "has_none_of",
-  "HAS_NONE_OF",
-  "empty",
-  "EMPTY",
-  "nempty",
-  "NEMPTY",
-] as const;
-
-const filterOp = Type.String({ enum: [...filterOps] });
-
-const params = Type.Object({
-  market: Type.Optional(
-    Type.String({ description: "TradingView market path segment. Default: america" }),
-  ),
-  columns: Type.Optional(
-    Type.Array(
-      Type.String({
-        description:
-          "TradingView scanner field, optionally timeframe-qualified (for example RSI|60)",
-      }),
-    ),
-  ),
-  filter: Type.Optional(
-    Type.Array(
-      Type.Object({
-        field: Type.String({
-          description: "TradingView scanner field, optionally timeframe-qualified",
-        }),
-        op: filterOp,
-        value: Type.Optional(
-          Type.Unknown({ description: "Filter value for operations that require one" }),
-        ),
-      }),
-      { description: "Flat AND filter clauses; nested OR trees are not supported" },
-    ),
-  ),
-  sort: Type.Optional(
-    Type.Object({
-      field: Type.String({ description: "TradingView scanner field to sort by" }),
-      direction: Type.Optional(Type.String({ enum: ["asc", "ASC", "desc", "DESC"] })),
-    }),
-  ),
-  limit: Type.Optional(
-    Type.Number({ description: "Maximum rows to return. Default 50; maximum 500" }),
-  ),
-});
-
-export const screenStocksTool: AgentTool<typeof params, ScreenerRow[]> = {
-  name: "screen_stocks",
-  label: "Stock Screener",
-  description:
-    'Screen stocks across a market using TradingView scanner filters, columns, sorting, and row limits. Use for breadth queries like finding large caps, oversold stocks, movers, or filtered market lists; use quote/history tools for single-security quote or history requests. Common aliases are accepted: gt/gte/lt/lte for comparisons, market_cap for market_cap_basic, change_percent for change, and RSI|14D for RSI. For sector screens, use the sector field; technology usually means sector in_range ["Electronic Technology", "Technology Services"]. Use description for company names because name is the ticker.',
-  parameters: params,
-  async execute(_toolCallId, args) {
-    const normalized = normalizeArgs(args);
-    const result = await wrapProvider("tradingview", () =>
-      screenStocks({
-        market: normalized.market,
-        columns: normalized.columns,
-        filter: normalized.filter,
-        sort: normalized.sort,
-        limit: normalized.limit,
-      }),
-    );
-
-    if (result.status === "unavailable") {
-      return {
-        content: [
-          {
-            type: "text",
-            text: [
-              `Stock screening unavailable (${result.reason}).`,
-              "Manual fallback: run the same screen in TradingView or another screener with the requested filters and sort. Treat matches as candidates, not recommendations, and verify live quotes/news before acting.",
-            ].join("\n"),
-          },
-        ],
-        details: [],
-      };
-    }
-
-    const rows = result.data;
-    const freshness = buildFreshnessStamp({
-      cached: result.cached,
-      stale: result.stale,
-      cachedAt: result.cached || result.stale ? result.timestamp : undefined,
-      dataDelayMs: 15 * 60_000,
-    });
-    if (rows.length === 0) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: [
-              "No stocks matched the screen. TradingView scanner data may be delayed about 15 minutes and comes from an unofficial endpoint.",
-              formatAsOfLine(freshness),
-            ].join("\n"),
-          },
-        ],
-        details: rows,
-      };
-    }
-
-    const lines = [
-      `**Stock screen** — ${rows.length} TradingView result${rows.length === 1 ? "" : "s"}`,
-      rows[0]?.dataCaveat ??
-        "TradingView scanner data may be delayed about 15 minutes and comes from an unofficial endpoint.",
-      formatInterpretationNote(normalized),
-      "",
-      ...rows.map(formatRow),
-      formatAsOfLine(freshness),
-    ];
-
-    return {
-      content: [{ type: "text", text: lines.join("\n") }],
-      details: rows,
-    };
-  },
-};
-
-function normalizeArgs(args: Static<typeof params>) {
-  return {
-    ...args,
-    columns: args.columns
-      ?.map(normalizeField)
-      .filter((field, index, fields) => fields.indexOf(field) === index),
-    filter: args.filter?.map((clause) => ({
-      ...clause,
-      field: normalizeField(clause.field),
-      op: normalizeFilterOp(clause.op),
-      ...(clause.value !== undefined && { value: normalizeValue(clause.value) }),
-    })),
-    sort: args.sort && {
-      ...args.sort,
-      field: normalizeField(args.sort.field),
-      direction: normalizeSortDirection(args.sort.direction),
-    },
-  };
-}
-
-function normalizeFilterOp(op: string): ScreenFilterOp {
-  const normalized = op.toLowerCase();
-  if (normalized === "gt" || normalized === ">") return "greater";
-  if (normalized === "gte" || normalized === ">=") return "egreater";
-  if (normalized === "lt" || normalized === "<") return "less";
-  if (normalized === "lte" || normalized === "<=") return "eless";
-  if (normalized === "eq" || normalized === "==") return "equal";
-  if (normalized === "neq" || normalized === "!=") return "nequal";
-  return normalized as ScreenFilterOp;
-}
-
-function normalizeSortDirection(direction?: string): "asc" | "desc" | undefined {
-  const normalized = direction?.toLowerCase();
-  if (normalized === "asc" || normalized === "desc") return normalized;
-  return undefined;
-}
-
-function normalizeField(field: string): string {
-  const trimmed = field.trim();
-  const lower = trimmed.toLowerCase();
-  if (lower === "market_cap" || lower === "marketcap") return "market_cap_basic";
-  if (lower === "total_volume" || lower === "share_volume" || lower === "shares_traded")
-    return "volume";
-  if (
-    lower === "change_percent" ||
-    lower === "percent_change" ||
-    lower === "daily_change_percent" ||
-    lower === "day_change_percent" ||
-    lower === "price_change_percent"
-  )
-    return "change";
-  if (lower === "company_name" || lower === "company" || lower === "security_name")
-    return "description";
-  if (/^rsi(?:\|(?:14|14d|14d\|close|1d|d|daily))?$/i.test(trimmed)) return "RSI";
-  return trimmed;
-}
-
-function formatInterpretationNote(args: ReturnType<typeof normalizeArgs>): string {
-  const fields = [
-    ...(args.columns ?? []),
-    ...(args.filter?.map((clause) => clause.field) ?? []),
-    args.sort?.field,
-  ].filter(Boolean);
-  const hasField = (field: string) => fields.includes(field);
-  const notes = ["Treat screen results as candidates, not recommendations."];
-  if (hasField("RSI"))
-    notes.push("RSI below 30 can mark oversold momentum, but it is not a buy signal by itself.");
-  if (args.sort?.field === "volume")
-    notes.push(
-      "Volume sorting shows the most actively traded matches rather than unusual volume by itself.",
-    );
-  if (hasField("change"))
-    notes.push(
-      "Daily percent change depends on the current market session; confirm market status and live quotes before acting.",
-    );
-  return `Interpretation note: ${notes.join(" ")}`;
-}
-
-function normalizeValue(value: unknown): unknown {
-  if (typeof value !== "string") return value;
-  const trimmed = value.trim().replace(/,/g, "");
-  if (/^[+-]?\d+(?:\.\d+)?$/.test(trimmed)) return Number(trimmed);
-  const short = /^\$?(\d+(?:\.\d+)?)\s*([kmbt])$/i.exec(trimmed);
-  if (short) return Number(short[1]) * multiplierFor(short[2]);
-  const long = /^\$?(\d+(?:\.\d+)?)\s*(thousand|million|billion|trillion)$/i.exec(trimmed);
-  if (long) return Number(long[1]) * multiplierFor(long[2]);
-  return value;
-}
-
-function multiplierFor(unit: string): number {
-  const normalized = unit.toLowerCase();
-  if (normalized === "k" || normalized === "thousand") return 1_000;
-  if (normalized === "m" || normalized === "million") return 1_000_000;
-  if (normalized === "b" || normalized === "billion") return 1_000_000_000;
-  return 1_000_000_000_000;
-}
-
-function formatRow(row: ScreenerRow): string {
-  const entries = Object.entries(row.values)
-    .filter(([field]) => field !== "name")
-    .slice(0, 8)
-    .map(([field, value]) => `${field}: ${formatValue(value)}`);
-  const suffix = entries.length > 0 ? ` — ${entries.join(" | ")}` : "";
-  return `  ${row.symbol} (${row.tvSymbol})${suffix}`;
-}
-
-function formatValue(value: unknown): string {
-  if (typeof value === "number")
-    return Number.isInteger(value) ? value.toLocaleString() : value.toFixed(2);
-  if (value === null || value === undefined) return "N/A";
-  if (Array.isArray(value)) return value.join(", ");
-  return String(value);
-}

package/src/tools/market/search-ticker.ts

@@ -1,254 +0,0 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { Type } from "@sinclair/typebox";
-import { httpGet, httpPost } from "../../infra/http-client.js";
-import { rateLimiter } from "../../infra/rate-limiter.js";
-
-const params = Type.Object({
-  query: Type.String({
-    description:
-      "Search query — company name, ticker symbol, or crypto name (e.g. 'apple', 'AAPL', 'ethereum', 'bitcoin')",
-  }),
-});
-
-interface YahooSearchResponse {
-  quotes?: YahooSearchQuote[];
-}
-
-interface YahooSearchQuote {
-  symbol: string;
-  shortname?: string;
-  longname?: string;
-  quoteType: string;
-  exchange: string;
-  score: number;
-}
-
-interface TradingViewSearchResponse {
-  fields?: string[];
-  symbols?: Array<{
-    s: string;
-    f: unknown[];
-  }>;
-}
-
-const FALLBACK_SEARCH_MAX_RETRY_AFTER_MS = 1_000;
-
-export const searchTickerTool: AgentTool<typeof params> = {
-  name: "search_ticker",
-  label: "Search Ticker",
-  description:
-    "Search for any ticker symbol — stocks, crypto, ETFs, indices, forex. Returns matching symbols with names and exchange info. Use this when you don't know the exact ticker for an asset.",
-  parameters: params,
-  async execute(_toolCallId, args) {
-    const yahoo = await searchYahoo(args.query);
-    const fallback = yahoo.quotes.length > 0 ? { quotes: [] } : await searchTradingView(args.query);
-    const quotes = yahoo.quotes.length > 0 ? yahoo.quotes : fallback.quotes;
-
-    if (quotes.length === 0) {
-      const fallbackError = "error" in fallback ? fallback.error : undefined;
-      return {
-        content: [
-          {
-            type: "text",
-            text: formatNoResultsText(args.query, yahoo.error, fallbackError),
-          },
-        ],
-        details: quotes,
-      };
-    }
-
-    const lines = [
-      `**Search results for "${args.query}"** — ${quotes.length} matches${yahoo.quotes.length === 0 ? " (TradingView fallback)" : ""}`,
-      "",
-      ...quotes.map(
-        (q) =>
-          `  ${q.symbol} — ${q.longname || q.shortname || "N/A"} (${q.quoteType}, ${q.exchange})`,
-      ),
-    ];
-
-    return { content: [{ type: "text", text: lines.join("\n") }], details: quotes };
-  },
-};
-
-function formatNoResultsText(
-  query: string,
-  yahooError?: string,
-  tradingViewError?: string,
-): string {
-  if (yahooError && tradingViewError) {
-    return `No results found for "${query}". Yahoo search was unavailable (${yahooError}), and the TradingView fallback was unavailable (${tradingViewError}).`;
-  }
-  if (yahooError) {
-    return `No results found for "${query}". Yahoo search was unavailable (${yahooError}), and the TradingView fallback found no equity matches.`;
-  }
-  if (tradingViewError) {
-    return `No results found for "${query}". TradingView fallback was unavailable (${tradingViewError}).`;
-  }
-  return `No results found for "${query}"`;
-}
-
-async function searchYahoo(query: string): Promise<{ quotes: YahooSearchQuote[]; error?: string }> {
-  const url = `https://query1.finance.yahoo.com/v1/finance/search?q=${encodeURIComponent(query)}&quotesCount=10&newsCount=0`;
-  try {
-    await rateLimiter.acquire("yahoo");
-    const data = await httpGet<YahooSearchResponse>(url, {
-      headers: { "User-Agent": "OpenCandle/1.0" },
-      maxRetryAfterMs: FALLBACK_SEARCH_MAX_RETRY_AFTER_MS,
-    });
-    return { quotes: data.quotes ?? [] };
-  } catch (error) {
-    return {
-      quotes: [],
-      error: error instanceof Error ? error.message : "unknown_error",
-    };
-  }
-}
-
-async function searchTradingView(
-  query: string,
-): Promise<{ quotes: YahooSearchQuote[]; error?: string }> {
-  const normalized = query.trim();
-  if (!normalized) return { quotes: [] };
-
-  try {
-    const exactTicker = normalizeTickerQuery(normalized);
-    if (exactTicker) {
-      const exact = await fetchTradingViewSearch(
-        buildTradingViewSearchBody({
-          query: normalized,
-          ticker: exactTicker,
-          mode: "ticker",
-        }),
-      );
-      const exactQuotes = decodeTradingViewSearch(exact, normalized).slice(0, 10);
-      if (exactQuotes.length > 0) return { quotes: exactQuotes };
-    }
-
-    const matched = await fetchTradingViewSearch(
-      buildTradingViewSearchBody({
-        query: normalized,
-        mode: "description",
-      }),
-    );
-    return { quotes: decodeTradingViewSearch(matched, normalized).slice(0, 10) };
-  } catch (error) {
-    return {
-      quotes: [],
-      error: error instanceof Error ? error.message : "unknown_error",
-    };
-  }
-}
-
-async function fetchTradingViewSearch(
-  body: ReturnType<typeof buildTradingViewSearchBody>,
-): Promise<TradingViewSearchResponse> {
-  await rateLimiter.acquire("tradingview");
-  return await httpPost<TradingViewSearchResponse>(
-    "https://scanner.tradingview.com/america/scan2?label-product=screener-stock",
-    body,
-    {
-      headers: {
-        Origin: "https://www.tradingview.com",
-        Referer: "https://www.tradingview.com/",
-        "User-Agent":
-          "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
-      },
-    },
-  );
-}
-
-function buildTradingViewSearchBody(options: {
-  query: string;
-  mode: "ticker" | "description";
-  ticker?: string;
-}) {
-  const columns = ["name", "description", "exchange", "type", "typespecs"] as const;
-  const filter =
-    options.mode === "ticker" && options.ticker
-      ? [
-          { left: "name", operation: "equal", right: options.ticker },
-          { left: "is_primary", operation: "equal", right: true },
-          { left: "type", operation: "in_range", right: ["stock", "fund", "dr"] },
-        ]
-      : [
-          { left: "description", operation: "match", right: options.query },
-          { left: "type", operation: "in_range", right: ["stock", "fund", "dr"] },
-        ];
-
-  return {
-    markets: ["america"],
-    columns,
-    filter,
-    sort: { sortBy: "market_cap_basic", sortOrder: "desc" },
-    range: [0, 10],
-    options: { lang: "en" },
-  };
-}
-
-function decodeTradingViewSearch(
-  response: TradingViewSearchResponse,
-  query: string,
-): YahooSearchQuote[] {
-  const fields = response.fields ?? [];
-  const queryTicker = normalizeTickerQuery(query);
-  return (response.symbols ?? [])
-    .map((row, index) => {
-      const values = Object.fromEntries(
-        fields.map((field, fieldIndex) => [field, row.f[fieldIndex]]),
-      );
-      const symbol = stringValue(values.name) ?? symbolFromTvSymbol(row.s);
-      const longname = stringValue(values.description);
-      const exchange = stringValue(values.exchange) ?? exchangeFromTvSymbol(row.s);
-      return {
-        symbol,
-        shortname: longname,
-        longname,
-        quoteType: quoteTypeFromTradingView(values.type, values.typespecs),
-        exchange,
-        score: scoreTradingViewResult({ symbol, exchange, index, queryTicker }),
-      };
-    })
-    .sort((a, b) => b.score - a.score || a.symbol.localeCompare(b.symbol));
-}
-
-function scoreTradingViewResult(opts: {
-  symbol: string;
-  exchange: string;
-  index: number;
-  queryTicker?: string;
-}): number {
-  let score = 50_000 - opts.index;
-  if (opts.queryTicker && opts.symbol.toUpperCase() === opts.queryTicker) score += 50_000;
-  const exchange = opts.exchange.toUpperCase();
-  if (exchange === "NASDAQ" || exchange === "NYSE") score += 1_000;
-  if (exchange === "AMEX") score += 500;
-  return score;
-}
-
-function quoteTypeFromTradingView(type: unknown, typespecs: unknown): string {
-  const normalizedType = stringValue(type)?.toLowerCase();
-  const normalizedSpecs = Array.isArray(typespecs)
-    ? typespecs.map((value) => String(value).toLowerCase())
-    : [];
-  if (normalizedType === "fund" && normalizedSpecs.includes("etf")) return "ETF";
-  if (normalizedType === "fund") return "MUTUALFUND";
-  if (normalizedType === "dr") return "EQUITY";
-  return "EQUITY";
-}
-
-function normalizeTickerQuery(query: string): string | undefined {
-  const normalized = query.trim().toUpperCase();
-  return /^[A-Z0-9][A-Z0-9.-]{0,9}$/.test(normalized) ? normalized : undefined;
-}
-
-function symbolFromTvSymbol(tvSymbol: string): string {
-  return tvSymbol.includes(":") ? tvSymbol.split(":").at(-1)! : tvSymbol;
-}
-
-function exchangeFromTvSymbol(tvSymbol: string): string {
-  return tvSymbol.includes(":") ? tvSymbol.split(":")[0] : "";
-}
-
-function stringValue(value: unknown): string | undefined {
-  return typeof value === "string" ? value : undefined;
-}

package/src/tools/market/stock-history.ts

@@ -1,104 +0,0 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { Type } from "@sinclair/typebox";
-import { getConfig } from "../../config.js";
-import { getDailyHistory } from "../../providers/alpha-vantage.js";
-import { withFallback } from "../../providers/with-fallback.js";
-import { wrapProvider } from "../../providers/wrap-provider.js";
-import { getHistory } from "../../providers/yahoo-finance.js";
-import type { ProviderResult } from "../../runtime/evidence.js";
-import type { OHLCV } from "../../types/market.js";
-
-const DAILY_INTERVALS = new Set(["1d", "1wk", "1mo"]);
-const HISTORY_RANGES = [
-  "1d",
-  "5d",
-  "1mo",
-  "3mo",
-  "6mo",
-  "ytd",
-  "1y",
-  "2y",
-  "5y",
-  "10y",
-  "max",
-] as const;
-const HISTORY_INTERVALS = ["1m", "5m", "15m", "1h", "1d", "1wk", "1mo"] as const;
-
-const params = Type.Object({
-  symbol: Type.String({ description: "Stock ticker symbol (e.g. AAPL, MSFT)" }),
-  range: Type.Optional(
-    Type.Union(
-      HISTORY_RANGES.map((range) => Type.Literal(range)),
-      {
-        description: "Time range: 1d, 5d, 1mo, 3mo, 6mo, ytd, 1y, 2y, 5y, 10y, max. Default: 6mo",
-      },
-    ),
-  ),
-  interval: Type.Optional(
-    Type.Union(
-      HISTORY_INTERVALS.map((interval) => Type.Literal(interval)),
-      {
-        description: "Data interval: 1m, 5m, 15m, 1h, 1d, 1wk, 1mo. Default: 1d",
-      },
-    ),
-  ),
-});
-
-export const stockHistoryTool: AgentTool<typeof params, OHLCV[]> = {
-  name: "get_stock_history",
-  label: "Stock History",
-  description: "Get historical OHLCV (open, high, low, close, volume) data for a stock",
-  parameters: params,
-  async execute(_toolCallId, args) {
-    const symbol = args.symbol.toUpperCase();
-    const range = args.range ?? "6mo";
-    const interval = args.interval ?? "1d";
-    const apiKey = getConfig().alphaVantageApiKey;
-
-    let result: ProviderResult<OHLCV[]>;
-
-    if (DAILY_INTERVALS.has(interval) && apiKey) {
-      // Daily or above — can fall back to Alpha Vantage
-      result = await withFallback([
-        { provider: "yahoo", fn: () => getHistory(symbol, range, interval) },
-        { provider: "alphavantage", fn: () => getDailyHistory(symbol, apiKey, range) },
-      ]);
-    } else {
-      // Intraday — no cross-provider fallback
-      result = await wrapProvider("yahoo", () => getHistory(symbol, range, interval));
-    }
-
-    if (result.status === "unavailable") {
-      const intradayNote = !DAILY_INTERVALS.has(interval)
-        ? ` No alternate source for ${interval} data.`
-        : "";
-      return {
-        content: [
-          {
-            type: "text",
-            text: `⚠ Stock history unavailable for ${symbol} (${result.reason}).${intradayNote}`,
-          },
-        ],
-        details: [],
-      };
-    }
-    const bars = result.data;
-
-    const summary = [
-      `${symbol} — ${bars.length} bars (${range}, ${interval})`,
-      `Period: ${bars[0]?.date} to ${bars[bars.length - 1]?.date}`,
-    ];
-
-    // Include last 10 bars as sample
-    const recent = bars.slice(-10);
-    const table = recent
-      .map(
-        (b) =>
-          `${b.date} | O:${b.open.toFixed(2)} H:${b.high.toFixed(2)} L:${b.low.toFixed(2)} C:${b.close.toFixed(2)} V:${b.volume.toLocaleString()}`,
-      )
-      .join("\n");
-
-    const text = [...summary, "", "Recent bars:", table].join("\n");
-    return { content: [{ type: "text", text }], details: bars };
-  },
-};