opencandle 0.4.0 → 0.6.0

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

@@ -1,28 +1,37 @@
 import { Type } from "@sinclair/typebox";
-import { getSeries } from "../../providers/fred.js";
-import { wrapProvider } from "../../providers/wrap-provider.js";
 import { getConfig } from "../../config.js";
 import { withCredentialCheck } from "../../onboarding/tool-helpers.js";
+import { getSeries } from "../../providers/fred.js";
+import { wrapProvider } from "../../providers/wrap-provider.js";
 import { FRED_SERIES } from "../../types/macro.js";
 const params = Type.Object({
     series_id: Type.String({
-        description: `FRED series ID. Common ones: ${Object.entries(FRED_SERIES).map(([k, v]) => `${v} (${k})`).join(", ")}`,
+        description: `FRED series ID. Common ones: ${Object.entries(FRED_SERIES)
+            .map(([k, v]) => `${v} (${k})`)
+            .join(", ")}`,
     }),
-    limit: Type.Optional(Type.Number({ description: "Number of observations to return. Default: 30" })),
+    limit: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 1000,
+        description: "Number of observations to return. Default: 30",
+    })),
 });
 export const fredDataTool = {
     name: "get_economic_data",
     label: "FRED Economic Data",
     description: "Get economic data from FRED (Federal Reserve Economic Data): interest rates, CPI, GDP, unemployment, yield curve, and more. Requires FRED.",
     parameters: params,
-    async execute(toolCallId, args) {
+    async execute(_toolCallId, args) {
         return withCredentialCheck("fred", async () => {
             const apiKey = getConfig().fredApiKey;
-            const limit = args.limit ?? 30;
-            const result = await wrapProvider("fred", () => getSeries(args.series_id.toUpperCase(), apiKey, limit));
+            const seriesId = args.series_id.toUpperCase();
+            const limit = normalizeLimit(seriesId, args.limit);
+            const result = await wrapProvider("fred", () => getSeries(seriesId, apiKey, limit));
             if (result.status === "unavailable") {
                 return {
-                    content: [{ type: "text", text: `⚠ FRED data unavailable for ${args.series_id.toUpperCase()} (${result.reason}).` }],
+                    content: [
+                        { type: "text", text: `⚠ FRED data unavailable for ${seriesId} (${result.reason}).` },
+                    ],
                     details: null,
                 };
             }
@@ -31,10 +40,13 @@ export const fredDataTool = {
             const header = `**${series.title}** (${series.id})`;
             const meta = `Units: ${series.units} | Frequency: ${series.frequency} | Last updated: ${series.lastUpdated}`;
             const current = latest ? `Latest: ${latest.value} (${latest.date})` : "No data";
+            const derived = formatDerivedChange(series);
             // Show last 10 observations
             const recent = series.observations.slice(-10);
             const table = recent.map((o) => `${o.date}: ${o.value}`).join("\n");
-            const text = [header, meta, current, "", "Recent observations:", table].join("\n");
+            const text = [header, meta, current, derived, "", "Recent observations:", table]
+                .filter(Boolean)
+                .join("\n");
             const prefix = result.stale
                 ? `⚠ Using cached FRED data from ${result.timestamp} (FRED unavailable)\n`
                 : "";
@@ -42,4 +54,27 @@ export const fredDataTool = {
         });
     },
 };
+function normalizeLimit(seriesId, requested) {
+    const limit = requested ?? 30;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 1000) {
+        throw new Error("limit must be an integer between 1 and 1000.");
+    }
+    if (seriesId === FRED_SERIES.CPI && limit < 13)
+        return 13;
+    return limit;
+}
+function formatDerivedChange(series) {
+    const latest = series.observations.at(-1);
+    if (!latest)
+        return null;
+    if (!/monthly/i.test(series.frequency) || !/\bindex\b/i.test(series.units))
+        return null;
+    const latestYear = Number(latest.date.slice(0, 4));
+    const monthDay = latest.date.slice(4);
+    const prior = series.observations.find((observation) => observation.date === `${latestYear - 1}${monthDay}`);
+    if (!prior || prior.value === 0)
+        return null;
+    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/macro/fred-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"fred-data.js","sourceRoot":"","sources":["../../../src/tools/macro/fred-data.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fred-data.js","sourceRoot":"","sources":["../../../src/tools/macro/fred-data.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,7 @@
 import { Type } from "@sinclair/typebox";
 import { getCryptoHistory } from "../../providers/coingecko.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
+import { computeRiskMetrics } from "../portfolio/risk-analysis.js";
 const params = Type.Object({
     id: Type.String({
         description: "CoinGecko coin ID (e.g. bitcoin, ethereum, solana)",
@@ -14,13 +15,15 @@ export const cryptoHistoryTool = {
     label: "Crypto History",
     description: "Get historical OHLC data for a cryptocurrency",
     parameters: params,
-    async execute(toolCallId, args) {
+    async execute(_toolCallId, args) {
         const id = args.id.toLowerCase();
         const days = args.days ?? 180;
         const result = await wrapProvider("coingecko", () => getCryptoHistory(id, days));
         if (result.status === "unavailable") {
             return {
-                content: [{ type: "text", text: `⚠ Crypto history unavailable for ${id} (${result.reason}).` }],
+                content: [
+                    { type: "text", text: `⚠ Crypto history unavailable for ${id} (${result.reason}).` },
+                ],
                 details: [],
             };
         }
@@ -33,8 +36,23 @@ export const cryptoHistoryTool = {
         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)}`)
             .join("\n");
-        const text = [...summary, "", "Recent bars:", table].join("\n");
+        const riskLines = buildRiskLines(id, bars);
+        const text = [...summary, ...riskLines, "", "Recent bars:", table].join("\n");
         return { content: [{ type: "text", text }], details: bars };
     },
 };
+function buildRiskLines(id, bars) {
+    if (bars.length < 30)
+        return [];
+    const metrics = computeRiskMetrics(id.toUpperCase(), bars.map((bar) => bar.close));
+    return [
+        "",
+        "Risk metrics from crypto history:",
+        `Annualized Return: ${(metrics.annualizedReturn * 100).toFixed(2)}%`,
+        `Annualized Volatility: ${(metrics.annualizedVolatility * 100).toFixed(2)}%`,
+        `Sharpe Ratio: ${metrics.sharpeRatio.toFixed(2)}`,
+        `Max Drawdown: ${(metrics.maxDrawdown * 100).toFixed(2)}%`,
+        `Value at Risk (95%, daily): ${(metrics.var95 * 100).toFixed(2)}%`,
+    ];
+}
 //# sourceMappingURL=crypto-history.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"crypto-history.js","sourceRoot":"","sources":["../../../src/tools/market/crypto-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;QACd,WAAW,EAAE,oDAAoD;KAClE,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,0EAA0E;KACxF,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IAClE,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,+CAA+C;IAC5D,UAAU,EAAE,MAAM;IAClB,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACjF,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oCAAoC,EAAE,KAAK,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC/F,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAEzB,MAAM,OAAO,GAAG;YACd,GAAG,EAAE,MAAM,IAAI,CAAC,MAAM,UAAU,IAAI,QAAQ;YAC5C,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;SAC7D,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM;aACjB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC5G;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;CACF,CAAC"}
+{"version":3,"file":"crypto-history.js","sourceRoot":"","sources":["../../../src/tools/market/crypto-history.ts"],"names":[],"mappings":"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"}

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

@@ -11,11 +11,13 @@ export const cryptoPriceTool = {
     label: "Crypto Price",
     description: "Get current crypto price, 24h change, market cap, volume, ATH, and supply data",
     parameters: params,
-    async execute(toolCallId, args) {
+    async execute(_toolCallId, args) {
         const result = await wrapProvider("coingecko", () => getCryptoPrice(args.id.toLowerCase()));
         if (result.status === "unavailable") {
             return {
-                content: [{ type: "text", text: `⚠ Crypto price unavailable for ${args.id} (${result.reason}).` }],
+                content: [
+                    { type: "text", text: `⚠ Crypto price unavailable for ${args.id} (${result.reason}).` },
+                ],
                 details: null,
             };
         }

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

@@ -1 +1 @@
-{"version":3,"file":"crypto-price.js","sourceRoot":"","sources":["../../../src/tools/market/crypto-price.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"crypto-price.js","sourceRoot":"","sources":["../../../src/tools/market/crypto-price.ts"],"names":[],"mappings":"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"}

package/dist/tools/market/screen-stocks.d.ts

@@ -0,0 +1,18 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { ScreenerRow } from "../../providers/tradingview.js";
+declare const params: 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>;
+}>;
+export declare const screenStocksTool: AgentTool<typeof params, ScreenerRow[]>;
+export {};

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

@@ -0,0 +1,252 @@
+import { Type } from "@sinclair/typebox";
+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",
+];
+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 = {
+    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;
+        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.",
+                    },
+                ],
+                details: rows,
+            };
+        }
+        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.`,
+            formatInterpretationNote(normalized),
+            "",
+            ...rows.map(formatRow),
+        ];
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            details: rows,
+        };
+    },
+};
+function normalizeArgs(args) {
+    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) {
+    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;
+}
+function normalizeSortDirection(direction) {
+    const normalized = direction?.toLowerCase();
+    if (normalized === "asc" || normalized === "desc")
+        return normalized;
+    return undefined;
+}
+function normalizeField(field) {
+    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) {
+    const fields = [
+        ...(args.columns ?? []),
+        ...(args.filter?.map((clause) => clause.field) ?? []),
+        args.sort?.field,
+    ].filter(Boolean);
+    const hasField = (field) => 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) {
+    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) {
+    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) {
+    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) {
+    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);
+}
+//# sourceMappingURL=screen-stocks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen-stocks.js","sourceRoot":"","sources":["../../../src/tools/market/screen-stocks.ts"],"names":[],"mappings":"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"}