opencandle 0.11.0 → 0.12.0

package/dist/tools/macro/event-probabilities.js

@@ -0,0 +1,120 @@
+import { Type } from "@sinclair/typebox";
+import { searchPredictionMarkets } from "../../providers/polymarket.js";
+import { wrapProvider } from "../../providers/wrap-provider.js";
+import { renderUntrustedText, untrustedContentHeader } from "../sentiment/untrusted-text.js";
+const LOW_LIQUIDITY_VOLUME_USD = 10_000;
+const params = Type.Object({
+    query: Type.String({
+        minLength: 1,
+        description: "Free-text event question to search on Polymarket.",
+    }),
+    limit: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 50,
+        description: "Maximum number of outcome quotes to return. Default: 8.",
+    })),
+});
+export const eventProbabilitiesTool = {
+    name: "get_event_probabilities",
+    label: "Event Probabilities",
+    description: "Search Polymarket for market-implied event probabilities. Fetches and formats probabilities only; it does not analyze or forecast outcomes.",
+    parameters: params,
+    async execute(_toolCallId, args) {
+        const query = args.query.trim();
+        const limit = args.limit ?? 8;
+        const result = await wrapProvider("polymarket", () => searchPredictionMarkets(query, limit));
+        if (result.status === "unavailable") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Polymarket prediction markets unavailable for "${query}" (${result.reason}).`,
+                            "",
+                            caveatText(),
+                        ].join("\n"),
+                    },
+                ],
+                details: [],
+            };
+        }
+        const quotes = result.data;
+        const cacheDisclosure = result.stale && result.timestamp
+            ? [
+                `Using cached Polymarket data from ${new Date(result.timestamp).toISOString()} because the provider fallback returned stale cache.`,
+                "",
+            ]
+            : [];
+        const text = quotes.length === 0
+            ? [
+                ...cacheDisclosure,
+                `No Polymarket prediction markets found for "${query}".`,
+                "",
+                caveatText(),
+            ].join("\n")
+            : [
+                `**Polymarket event probabilities for "${query}"**`,
+                "",
+                ...cacheDisclosure,
+                untrustedContentHeader("Polymarket market text"),
+                "",
+                ...quotes.map(formatQuote),
+                "",
+                caveatText(),
+            ].join("\n");
+        return { content: [{ type: "text", text }], details: quotes.map(sanitizeQuoteDetails) };
+    },
+};
+function sanitizeQuoteDetails(quote) {
+    return {
+        source: quote.source,
+        marketId: renderUntrustedText(quote.marketId, 120),
+        title: renderUntrustedText(quote.title, 220),
+        outcome: renderUntrustedText(quote.outcome, 80),
+        probability: quote.probability,
+        ...(quote.volumeUsd !== undefined && { volumeUsd: quote.volumeUsd }),
+        ...(quote.liquidityUsd !== undefined && { liquidityUsd: quote.liquidityUsd }),
+        url: renderUntrustedText(quote.url, 500),
+        ...(quote.asOf && { asOf: renderUntrustedText(quote.asOf, 80) }),
+        ...(quote.closeDate && { closeDate: renderUntrustedText(quote.closeDate, 80) }),
+        ...(quote.resolutionCriteria && {
+            resolutionCriteria: renderUntrustedText(quote.resolutionCriteria, 1000),
+        }),
+    };
+}
+function formatQuote(quote) {
+    return [
+        `- ${formatPercent(quote.probability)} - ${renderUntrustedText(quote.outcome, 80)}: ${renderUntrustedText(quote.title, 220)}`,
+        `  Volume: ${formatUsd(quote.volumeUsd)} | Liquidity: ${formatUsd(quote.liquidityUsd)} | Close: ${quote.closeDate ? renderUntrustedText(quote.closeDate, 80) : "unknown"}`,
+        `  Updated: ${quote.asOf ? renderUntrustedText(quote.asOf, 80) : "unavailable from Polymarket"}`,
+        quote.volumeUsd !== undefined && quote.volumeUsd < LOW_LIQUIDITY_VOLUME_USD
+            ? "  LOW-LIQUIDITY: volume under $10,000"
+            : undefined,
+        `  Resolution criteria: ${quote.resolutionCriteria
+            ? renderUntrustedText(quote.resolutionCriteria, 1000)
+            : "Resolution criteria unavailable from Polymarket."}`,
+        `  URL: ${renderUntrustedText(quote.url, 500)}`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function formatPercent(value) {
+    return `${(value * 100).toFixed(1)}%`;
+}
+function formatUsd(value) {
+    if (value === undefined)
+        return "unavailable";
+    return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: "USD",
+        maximumFractionDigits: 2,
+    }).format(value);
+}
+function caveatText() {
+    return [
+        "Caveats:",
+        "- These are market-implied probabilities from trader positioning, not calibrated forecasts.",
+        "- Thin markets can show noisy or stale prices; results with volume under $10,000 are explicitly flagged low-liquidity.",
+        "- Polymarket is a crypto-settled venue with platform and settlement risks distinct from regulated exchanges.",
+    ].join("\n");
+}

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

@@ -1,7 +1,10 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type FreshnessStamp } from "../../infra/freshness.js";
 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

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { buildFreshnessStamp, formatAsOfLine } from "../../infra/freshness.js";
 import { getCryptoPrice } from "../../providers/coingecko.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 const params = Type.Object({
@@ -22,6 +23,13 @@ export const cryptoPriceTool = {
             };
         }
         const crypto = result.data;
+        const freshness = buildFreshnessStamp({
+            asOf: crypto.asOf,
+            cached: result.cached,
+            stale: result.stale,
+            cachedAt: result.cached || result.stale ? result.timestamp : undefined,
+            assetClass: "crypto",
+        });
         const sign = crypto.changePercent24h >= 0 ? "+" : "";
         const text = [
             `${crypto.name} (${crypto.symbol.toUpperCase()}): $${formatPrice(crypto.price)} (${sign}${crypto.changePercent24h.toFixed(2)}%)`,
@@ -29,8 +37,9 @@ export const cryptoPriceTool = {
             `Market Cap: $${formatLargeNumber(crypto.marketCap)} | 24h Volume: $${formatLargeNumber(crypto.volume24h)}`,
             `ATH: $${formatPrice(crypto.ath)} (${crypto.athDate.split("T")[0]})`,
             `Circulating: ${formatLargeNumber(crypto.circulatingSupply)} ${crypto.symbol.toUpperCase()}`,
+            formatAsOfLine(freshness),
         ].join("\n");
-        return { content: [{ type: "text", text }], details: crypto };
+        return { content: [{ type: "text", text }], details: { ...crypto, freshness } };
     },
 };
 function formatPrice(n) {
@@ -49,4 +58,3 @@ function formatLargeNumber(n) {
         return `${(n / 1e6).toFixed(2)}M`;
     return n.toLocaleString();
 }
-//# sourceMappingURL=crypto-price.js.map

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

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { buildFreshnessStamp, formatAsOfLine } from "../../infra/freshness.js";
 import { screenStocks } from "../../providers/tradingview.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 const filterOps = [
@@ -107,12 +108,21 @@ export const screenStocksTool = {
             };
         }
         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.",
+                        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,
@@ -120,11 +130,12 @@ export const screenStocksTool = {
         }
         const lines = [
             `**Stock screen** — ${rows.length} TradingView result${rows.length === 1 ? "" : "s"}`,
-            ...(result.stale ? [`⚠ Using cached TradingView screen from ${result.timestamp}.`] : []),
-            `Data freshness: ${result.stale ? `cached screen retrieved at ${result.timestamp}` : `retrieved at ${result.timestamp}`}; TradingView scanner data may be delayed about 15 minutes and comes from an unofficial endpoint.`,
+            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") }],
@@ -249,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.js

@@ -78,4 +78,3 @@ export const stockHistoryTool = {
         return { content: [{ type: "text", text }], details: bars };
     },
 };
-//# sourceMappingURL=stock-history.js.map

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

@@ -1,7 +1,10 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type FreshnessStamp } from "../../infra/freshness.js";
 import type { StockQuote } from "../../types/market.js";
 declare const params: import("@sinclair/typebox").TObject<{
     symbol: import("@sinclair/typebox").TString;
 }>;
-export declare const stockQuoteTool: AgentTool<typeof params, StockQuote>;
+export declare const stockQuoteTool: AgentTool<typeof params, (StockQuote & {
+    freshness: FreshnessStamp;
+}) | null>;
 export {};

package/dist/tools/market/stock-quote.js

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import { getConfig } from "../../config.js";
+import { buildFreshnessStamp, formatAsOfLine } from "../../infra/freshness.js";
 import { getGlobalQuote } from "../../providers/alpha-vantage.js";
 import { withFallback } from "../../providers/with-fallback.js";
 import { getQuote } from "../../providers/yahoo-finance.js";
@@ -30,6 +31,12 @@ export const stockQuoteTool = {
             };
         }
         const quote = result.data;
+        const freshness = buildFreshnessStamp({
+            asOf: quote.asOf,
+            cached: result.cached,
+            stale: result.stale,
+            cachedAt: result.cached || result.stale ? result.timestamp : undefined,
+        });
         const sign = quote.changePercent >= 0 ? "+" : "";
         const week52 = quote.week52High > 0 && quote.week52Low > 0
             ? `$${quote.week52Low.toFixed(2)} - $${quote.week52High.toFixed(2)}`
@@ -40,11 +47,9 @@ export const stockQuoteTool = {
             `Open: $${quote.open.toFixed(2)} | High: $${quote.high.toFixed(2)} | Low: $${quote.low.toFixed(2)}`,
             `Volume: ${quote.volume.toLocaleString()} | Market Cap: ${marketCapStr}`,
             `52W Range: ${week52}`,
+            formatAsOfLine(freshness),
         ].join("\n");
-        const prefix = result.stale
-            ? `⚠ Using cached quote from ${result.timestamp} (provider rate limited)\n`
-            : "";
-        return { content: [{ type: "text", text: prefix + text }], details: quote };
+        return { content: [{ type: "text", text }], details: { ...quote, freshness } };
     },
 };
 function formatLargeNumber(n) {
@@ -56,4 +61,3 @@ function formatLargeNumber(n) {
         return `${(n / 1e6).toFixed(2)}M`;
     return n.toLocaleString();
 }
-//# sourceMappingURL=stock-quote.js.map

package/dist/tools/options/greeks.js

@@ -61,4 +61,3 @@ function cdf(x) {
 function pdf(x) {
     return Math.exp(-0.5 * x * x) / Math.sqrt(2 * Math.PI);
 }
-//# sourceMappingURL=greeks.js.map

package/dist/tools/options/option-chain.d.ts

@@ -1,9 +1,12 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type FreshnessStamp } from "../../infra/freshness.js";
 import type { OptionsChain } from "../../types/options.js";
 declare const params: 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">]>>;
 }>;
-export declare const optionChainTool: AgentTool<typeof params, OptionsChain>;
+export declare const optionChainTool: AgentTool<typeof params, (OptionsChain & {
+    freshness: FreshnessStamp;
+}) | null>;
 export {};

package/dist/tools/options/option-chain.js

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { buildFreshnessStamp, formatAsOfLine } from "../../infra/freshness.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 import { getOptionsChain } from "../../providers/yahoo-finance.js";
 const params = Type.Object({
@@ -30,6 +31,12 @@ export const optionChainTool = {
             };
         }
         const chain = result.data;
+        const freshness = buildFreshnessStamp({
+            asOf: chain.asOf,
+            cached: result.cached,
+            stale: result.stale,
+            cachedAt: result.cached || result.stale ? result.timestamp : undefined,
+        });
         const lines = [
             `**${chain.symbol} Options Chain** — Expiry: ${chain.expirationDate}`,
             `Underlying: $${chain.underlyingPrice.toFixed(2)}`,
@@ -64,7 +71,11 @@ export const optionChainTool = {
             lines.push("");
         }
         lines.push(`Put/Call Ratio: ${chain.putCallRatio.toFixed(2)}`);
-        return { content: [{ type: "text", text: lines.join("\n") }], details: chain };
+        lines.push(formatAsOfLine(freshness));
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            details: { ...chain, freshness },
+        };
     },
 };
 function parseExpiration(expiration) {
@@ -87,4 +98,3 @@ function formatContract(c) {
     const itm = c.inTheMoney ? "*" : " ";
     return `${itm}$${c.strike.toFixed(2)} | $${c.bid.toFixed(2)}/$${c.ask.toFixed(2)} | $${c.lastPrice.toFixed(2)} | ${c.volume} | ${c.openInterest} | ${(c.impliedVolatility * 100).toFixed(1)}% | ${c.greeks.delta.toFixed(3)} | ${c.greeks.gamma.toFixed(3)} | ${c.greeks.theta.toFixed(3)} | ${c.greeks.vega.toFixed(3)} | ${c.greeks.rho.toFixed(3)}`;
 }
-//# sourceMappingURL=option-chain.js.map

package/dist/tools/portfolio/alerts.d.ts

@@ -1,6 +1,6 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 declare const params: 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<"list">, import("@sinclair/typebox").TLiteral<"status">, import("@sinclair/typebox").TLiteral<"check">]>;
+    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>;
@@ -8,6 +8,7 @@ declare const params: import("@sinclair/typebox").TObject<{
     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>;
 }>;