opencandle 0.11.1 → 0.12.0

package/src/providers/finnhub.ts

@@ -1,125 +0,0 @@
-import { cache, STALE_LIMIT, TTL } from "../infra/cache.js";
-import { HttpError, httpGet } from "../infra/http-client.js";
-import { rateLimiter } from "../infra/rate-limiter.js";
-import { ProviderCredentialError } from "./provider-credential-error.js";
-
-const FINNHUB_BASE = "https://finnhub.io/api/v1";
-
-export interface FinnhubArticle {
-  headline: string;
-  summary: string;
-  source: string;
-  datetime: number;
-  url: string;
-  related: string;
-  id: number;
-  category: string;
-  image: string;
-}
-
-// Ticker → company name mapping for relevance filtering
-const TICKER_NAMES: Record<string, string> = {
-  AAPL: "apple",
-  MSFT: "microsoft",
-  GOOGL: "google",
-  GOOG: "google",
-  AMZN: "amazon",
-  META: "meta",
-  TSLA: "tesla",
-  NVDA: "nvidia",
-  TSM: "tsmc",
-  BABA: "alibaba",
-  NFLX: "netflix",
-  AMD: "amd",
-  INTC: "intel",
-  CRM: "salesforce",
-  ORCL: "oracle",
-};
-
-export function finnhubDateRange(freshness: "hours" | "day" | "week" | "month"): {
-  from: string;
-  to: string;
-} {
-  const now = new Date();
-  const to = formatDate(now);
-
-  switch (freshness) {
-    case "hours":
-      return { from: to, to };
-    case "day": {
-      const d = new Date(now);
-      d.setDate(d.getDate() - 1);
-      return { from: formatDate(d), to };
-    }
-    case "week": {
-      const d = new Date(now);
-      d.setDate(d.getDate() - 7);
-      return { from: formatDate(d), to };
-    }
-    case "month": {
-      const d = new Date(now);
-      d.setDate(d.getDate() - 30);
-      return { from: formatDate(d), to };
-    }
-  }
-}
-
-function formatDate(d: Date): string {
-  return d.toISOString().slice(0, 10);
-}
-
-function cacheKey(symbol: string, from: string, to: string): string {
-  return `finnhub:news:${symbol}:${from}:${to}`;
-}
-
-export function filterByRelevance(
-  articles: FinnhubArticle[],
-  symbol: string,
-  limit = 20,
-): FinnhubArticle[] {
-  const symLower = symbol.toLowerCase();
-  const companyName = TICKER_NAMES[symbol.toUpperCase()];
-
-  const filtered = articles.filter((a) => {
-    const hl = a.headline.toLowerCase();
-    const sm = a.summary.toLowerCase();
-    if (hl.includes(symLower) || sm.includes(symLower)) return true;
-    if (companyName && (hl.includes(companyName) || sm.includes(companyName))) return true;
-    return false;
-  });
-
-  // Most recent first, capped
-  return filtered.sort((a, b) => b.datetime - a.datetime).slice(0, limit);
-}
-
-export async function getCompanyNews(
-  symbol: string,
-  from: string,
-  to: string,
-  apiKey: string,
-): Promise<FinnhubArticle[]> {
-  const key = cacheKey(symbol, from, to);
-  const cached = cache.get<FinnhubArticle[]>(key);
-  if (cached) return cached;
-
-  try {
-    await rateLimiter.acquire("finnhub");
-
-    const url = `${FINNHUB_BASE}/company-news?symbol=${encodeURIComponent(symbol)}&from=${from}&to=${to}&token=${apiKey}`;
-    const data = await httpGet<FinnhubArticle[]>(url);
-
-    const articles = Array.isArray(data) ? data : [];
-    const filtered = filterByRelevance(articles, symbol);
-
-    cache.set(key, filtered, TTL.FINNHUB_NEWS);
-    return filtered;
-  } catch (error) {
-    if (error instanceof HttpError && (error.status === 401 || error.status === 403)) {
-      throw new ProviderCredentialError("finnhub", "stale", error.status);
-    }
-
-    const stale = cache.getStale<FinnhubArticle[]>(key, STALE_LIMIT.FINNHUB_NEWS);
-    if (stale) return stale.value;
-    throw error;
-  }
-}

package/src/providers/fred.ts

@@ -1,83 +0,0 @@
-import { cache, STALE_LIMIT, TTL } from "../infra/cache.js";
-import { HttpError, httpGet } from "../infra/http-client.js";
-import { rateLimiter } from "../infra/rate-limiter.js";
-import type { FredObservation, FredSeries } from "../types/macro.js";
-import { ProviderCredentialError } from "./provider-credential-error.js";
-
-const BASE_URL = "https://api.stlouisfed.org/fred";
-
-interface FredSeriesResponse {
-  seriess: Array<{
-    id: string;
-    title: string;
-    units: string;
-    frequency: string;
-    last_updated: string;
-  }>;
-}
-
-interface FredObservationsResponse {
-  observations: Array<{
-    date: string;
-    value: string;
-  }>;
-}
-
-export async function getSeries(
-  seriesId: string,
-  apiKey: string,
-  limit: number = 60,
-): Promise<FredSeries> {
-  const cacheKey = `fred:series:${seriesId}:${limit}`;
-  const cached = cache.get<FredSeries>(cacheKey);
-  if (cached) return cached;
-
-  try {
-    await rateLimiter.acquire("fred");
-
-    // Fetch series metadata and observations in parallel
-    const metaUrl = `${BASE_URL}/series?series_id=${seriesId}&api_key=${apiKey}&file_type=json`;
-    const obsUrl = `${BASE_URL}/series/observations?series_id=${seriesId}&api_key=${apiKey}&file_type=json&sort_order=desc&limit=${limit}`;
-
-    const [metaData, obsData] = await Promise.all([
-      httpGet<FredSeriesResponse>(metaUrl),
-      httpGet<FredObservationsResponse>(obsUrl),
-    ]);
-
-    const meta = metaData.seriess[0];
-    const observations: FredObservation[] = obsData.observations
-      .filter((o) => o.value !== ".")
-      .map((o) => ({
-        date: o.date,
-        value: parseFloat(o.value),
-      }))
-      .reverse(); // chronological order
-
-    const result: FredSeries = {
-      id: meta.id,
-      title: meta.title,
-      observations,
-      units: meta.units,
-      frequency: meta.frequency,
-      lastUpdated: meta.last_updated,
-    };
-
-    cache.set(cacheKey, result, TTL.MACRO);
-    return result;
-  } catch (error) {
-    // FRED historically returns 400 with a body like "Bad Request. The value
-    // for variable api_key is not registered..." when the key is invalid. A
-    // separate 400 can also indicate a bad series_id, which is NOT a credential
-    // problem. We only reclassify as credential-related on 401/403 here to
-    // avoid surfacing a `/connect` prompt when the user's real mistake is a
-    // typo in a series id. Bad-FRED-key users will still see the raw error
-    // message in v1; a body-string check can be added later if this becomes a
-    // reported friction.
-    if (error instanceof HttpError && (error.status === 401 || error.status === 403)) {
-      throw new ProviderCredentialError("fred", "stale", error.status);
-    }
-    const stale = cache.getStale<FredSeries>(cacheKey, STALE_LIMIT.MACRO);
-    if (stale) return stale.value;
-    throw error;
-  }
-}

package/src/providers/index.ts

@@ -1,17 +0,0 @@
-export { getEarnings, getFinancials, getOverview } from "./alpha-vantage.js";
-export { getCryptoHistory, getCryptoPrice } from "./coingecko.js";
-export { getFearGreedIndex } from "./fear-greed.js";
-export { getSeries } from "./fred.js";
-export { getSubredditPosts, scoreSentiment } from "./reddit.js";
-export { type SECFiling, searchFilings } from "./sec-edgar.js";
-export { getQuotes, screenStocks } from "./tradingview.js";
-export type { WebSearchOpts } from "./web-search.js";
-export { braveSearch, ddgSearch, normalizeFinancialQuery, searchWeb } from "./web-search.js";
-export {
-  clearCrumbCache,
-  computeTimeToExpiry,
-  getHistory,
-  getOptionsChain,
-  getQuote,
-  getYahooCrumb,
-} from "./yahoo-finance.js";

package/src/providers/polymarket.ts

@@ -1,214 +0,0 @@
-import { cache, STALE_LIMIT, TTL } from "../infra/cache.js";
-import { httpGet } from "../infra/http-client.js";
-import { rateLimiter } from "../infra/rate-limiter.js";
-import type { PredictionMarketQuote } from "../types/prediction-markets.js";
-
-const BASE_URL = "https://gamma-api.polymarket.com";
-const POLYMARKET_URL = "https://polymarket.com";
-
-interface GammaSearchResponse {
-  events?: GammaEvent[];
-  markets?: GammaMarket[];
-}
-
-interface GammaEvent {
-  id?: string | number;
-  slug?: string;
-  title?: string;
-  description?: string;
-  resolutionSource?: string;
-  endDate?: string;
-  volume?: unknown;
-  liquidity?: unknown;
-  updatedAt?: string;
-  markets?: GammaMarket[];
-}
-
-interface GammaMarket {
-  id?: string | number;
-  question?: string;
-  slug?: string;
-  description?: string;
-  resolutionSource?: string;
-  outcomes?: unknown;
-  outcomePrices?: unknown;
-  volume?: unknown;
-  volumeNum?: unknown;
-  liquidity?: unknown;
-  liquidityNum?: unknown;
-  endDate?: string;
-  endDateIso?: string;
-  updatedAt?: string;
-  active?: unknown;
-  closed?: unknown;
-}
-
-interface MarketWithEvent {
-  event?: GammaEvent;
-  market: GammaMarket;
-}
-
-export async function searchPredictionMarkets(
-  query: string,
-  limit: number = 8,
-): Promise<PredictionMarketQuote[]> {
-  const normalizedQuery = query.trim();
-  const normalizedLimit = normalizeLimit(limit);
-  if (!normalizedQuery) return [];
-
-  const cacheKey = `polymarket:search:${normalizedQuery.toLowerCase()}:${normalizedLimit}`;
-  const cached = cache.get<PredictionMarketQuote[]>(cacheKey);
-  if (cached) return cached;
-
-  try {
-    await rateLimiter.acquire("polymarket");
-    const url = `${BASE_URL}/public-search?q=${encodeURIComponent(normalizedQuery)}&limit=${normalizedLimit}`;
-    const response = await httpGet<GammaSearchResponse>(url, {
-      headers: { Accept: "application/json" },
-      maxRetries: 0,
-    });
-    const quotes = decodeSearchResponse(response).slice(0, normalizedLimit);
-    cache.set(cacheKey, quotes, TTL.PREDICTION_MARKETS);
-    return quotes;
-  } catch (error) {
-    const stale = cache.getStale<PredictionMarketQuote[]>(cacheKey, STALE_LIMIT.PREDICTION_MARKETS);
-    if (stale) return stale.value;
-    throw error;
-  }
-}
-
-function decodeSearchResponse(response: GammaSearchResponse): PredictionMarketQuote[] {
-  const markets: MarketWithEvent[] = [
-    ...(response.events ?? []).flatMap((event) =>
-      (event.markets ?? []).map((market) => ({ event, market })),
-    ),
-    ...(response.markets ?? []).map((market) => ({ market })),
-  ];
-  return markets.flatMap(({ event, market }) =>
-    isOpenMarket(market) ? marketToQuotes(market, event) : [],
-  );
-}
-
-function marketToQuotes(market: GammaMarket, event?: GammaEvent): PredictionMarketQuote[] {
-  const marketId = market.id === undefined ? undefined : String(market.id);
-  const title = stringValue(market.question) ?? stringValue(event?.title);
-  if (!marketId || !title) return [];
-
-  const outcomes = parseStringArray(market.outcomes);
-  const prices = parseNumberArray(market.outcomePrices);
-  if (outcomes.length === 0 || prices.length === 0) return [];
-
-  const resolutionCriteria = firstNonEmpty(market.description, market.resolutionSource);
-  const volumeUsd =
-    numberValue(market.volumeNum) ?? numberValue(market.volume) ?? numberValue(event?.volume);
-  const liquidityUsd =
-    numberValue(market.liquidityNum) ??
-    numberValue(market.liquidity) ??
-    numberValue(event?.liquidity);
-  const closeDate =
-    stringValue(market.endDate) ?? normalizeDateOnly(market.endDateIso ?? event?.endDate);
-  const url = marketUrl(market, event);
-  const asOf = stringValue(market.updatedAt) ?? stringValue(event?.updatedAt);
-
-  return outcomes.flatMap((outcome, index) => {
-    const probability = prices[index];
-    if (probability === undefined || probability < 0 || probability > 1) return [];
-    return [
-      {
-        source: "polymarket" as const,
-        marketId,
-        title,
-        outcome,
-        probability,
-        ...(volumeUsd !== undefined && { volumeUsd }),
-        ...(liquidityUsd !== undefined && { liquidityUsd }),
-        ...(closeDate && { closeDate }),
-        ...(resolutionCriteria && { resolutionCriteria }),
-        url,
-        ...(asOf && { asOf }),
-      },
-    ];
-  });
-}
-
-function isOpenMarket(market: GammaMarket): boolean {
-  if (booleanValue(market.closed) === true) return false;
-  if (booleanValue(market.active) === false) return false;
-  const endDate = stringValue(market.endDate) ?? stringValue(market.endDateIso);
-  if (!endDate) return true;
-  const parsed = new Date(endDate);
-  return Number.isNaN(parsed.getTime()) || parsed.getTime() > Date.now();
-}
-
-function normalizeLimit(limit: number): number {
-  if (!Number.isFinite(limit)) return 8;
-  return Math.min(50, Math.max(1, Math.floor(limit)));
-}
-
-function parseStringArray(value: unknown): string[] {
-  const parsed = parseJsonArray(value);
-  return parsed.flatMap((item) => {
-    const text = stringValue(item);
-    return text ? [text] : [];
-  });
-}
-
-function parseNumberArray(value: unknown): Array<number | undefined> {
-  const parsed = parseJsonArray(value);
-  return parsed.map((item) => numberValue(item));
-}
-
-function parseJsonArray(value: unknown): unknown[] {
-  if (Array.isArray(value)) return value;
-  if (typeof value !== "string") return [];
-  try {
-    const parsed = JSON.parse(value);
-    return Array.isArray(parsed) ? parsed : [];
-  } catch {
-    return [];
-  }
-}
-
-function numberValue(value: unknown): number | undefined {
-  const number =
-    typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
-  return Number.isFinite(number) ? number : undefined;
-}
-
-function stringValue(value: unknown): string | undefined {
-  if (typeof value !== "string") return undefined;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : undefined;
-}
-
-function booleanValue(value: unknown): boolean | undefined {
-  if (typeof value === "boolean") return value;
-  if (typeof value !== "string") return undefined;
-  const normalized = value.trim().toLowerCase();
-  if (normalized === "true") return true;
-  if (normalized === "false") return false;
-  return undefined;
-}
-
-function firstNonEmpty(...values: unknown[]): string | undefined {
-  for (const value of values) {
-    const text = stringValue(value);
-    if (text) return text;
-  }
-  return undefined;
-}
-
-function normalizeDateOnly(value: string | undefined): string | undefined {
-  if (!value) return undefined;
-  return /^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00Z` : value;
-}
-
-function marketUrl(market: GammaMarket, event?: GammaEvent): string {
-  const marketSlug = stringValue(market.slug);
-  const eventSlug = stringValue(event?.slug);
-  if (eventSlug && marketSlug) {
-    return `${POLYMARKET_URL}/event/${encodeURIComponent(eventSlug)}/${encodeURIComponent(marketSlug)}`;
-  }
-  if (marketSlug) return `${POLYMARKET_URL}/event/${encodeURIComponent(marketSlug)}`;
-  return POLYMARKET_URL;
-}

package/src/providers/provider-credential-error.ts

@@ -1,23 +0,0 @@
-// Typed error thrown by providers when they detect a missing or stale credential.
-//
-// Providers remain pure fetchers that throw on failure — this class is the
-// structured hand-off to the tool layer, where `withCredentialCheck` catches
-// the error and emits a tagged tool-result content string.
-//
-// Keep this module dependency-free (aside from the ProviderId type) so it can
-// be imported from anywhere without pulling in config loading or registry
-// side effects.
-
-import type { ProviderId } from "../onboarding/providers.js";
-
-export class ProviderCredentialError extends Error {
-  readonly name = "ProviderCredentialError";
-
-  constructor(
-    readonly provider: ProviderId,
-    readonly reason: "missing" | "stale",
-    readonly httpStatus?: number,
-  ) {
-    super(`credential_required:${provider}:${reason}`);
-  }
-}