opencandle 0.11.1 → 0.12.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";
@@ -34,4 +33,119 @@ 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<"6mo" | "1y" | "2y">[]>>;
+}>, 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<{
+    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;
+    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">[]>>;
+}>, import("../types/market.js").OHLCV[]> | 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

@@ -98,4 +98,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/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.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

@@ -4,7 +4,7 @@ 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

@@ -61,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

@@ -6,7 +6,7 @@ declare const params: import("@sinclair/typebox").TObject<{
     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

@@ -98,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>;
 }>;

package/dist/tools/portfolio/alerts.js

@@ -16,6 +16,7 @@ const ACTION_DESCRIPTION = [
     "create_sma_cross_above/create_sma_cross_below for fast/slow SMA crossing alerts,",
     "create_rsi_above/create_rsi_below for RSI alerts,",
     "create_volume_spike for volume alerts, set_enabled to enable or disable an alert,",
+    "update to replace an alert rule definition, delete to remove a rule,",
     "and status to inspect local runner/check history.",
     "When the user asks to create an alert and check it now in the same request,",
     "set check_after_create to true on the create action.",
@@ -34,6 +35,8 @@ const params = Type.Object({
         Type.Literal("create_sma_cross_above"),
         Type.Literal("create_sma_cross_below"),
         Type.Literal("set_enabled"),
+        Type.Literal("update"),
+        Type.Literal("delete"),
         Type.Literal("list"),
         Type.Literal("status"),
         Type.Literal("check"),
@@ -58,6 +61,21 @@ const params = Type.Object({
         description: "Cooldown between repeated trigger events. Default: 3600",
     })),
     id: Type.Optional(Type.Number({ description: "Alert rule id for update actions" })),
+    condition_action: Type.Optional(Type.Union([
+        Type.Literal("create_price_above"),
+        Type.Literal("create_price_below"),
+        Type.Literal("create_price_above_sma"),
+        Type.Literal("create_price_below_sma"),
+        Type.Literal("create_rsi_above"),
+        Type.Literal("create_rsi_below"),
+        Type.Literal("create_volume_spike"),
+        Type.Literal("create_percent_move_up"),
+        Type.Literal("create_percent_move_down"),
+        Type.Literal("create_sma_cross_above"),
+        Type.Literal("create_sma_cross_below"),
+    ], {
+        description: "Create-style alert condition action to use when updating an existing alert rule.",
+    })),
     enabled: Type.Optional(Type.Boolean({ description: "Whether an alert rule is enabled" })),
     check_after_create: Type.Optional(Type.Boolean({
         description: "Set true only when the user asks to check/run alerts immediately after creating this alert in the same request.",
@@ -66,7 +84,7 @@ const params = Type.Object({
 export const alertsTool = {
     name: "manage_alerts",
     label: "Alerts",
-    description: "Create, pause/resume, list, check, and inspect status for durable local alerts. Actions include create_price_above, create_price_below, create_price_above_sma, create_price_below_sma, create_rsi_above, create_rsi_below, create_volume_spike, create_percent_move_up, create_percent_move_down, create_sma_cross_above, create_sma_cross_below, set_enabled, list, status, and check. Local background monitoring runs only while an OpenCandle writer/monitor process is active; manual checks are always available. If the user asks to create an alert and check it now, use the create action with check_after_create=true.",
+    description: "Create, update, delete, pause/resume, list, check, and inspect status for durable local alerts. Actions include create_price_above, create_price_below, create_price_above_sma, create_price_below_sma, create_rsi_above, create_rsi_below, create_volume_spike, create_percent_move_up, create_percent_move_down, create_sma_cross_above, create_sma_cross_below, set_enabled, update, delete, list, status, and check. Local background monitoring runs only while an OpenCandle writer/monitor process is active; manual checks are always available. If the user asks to create an alert and check it now, use the create action with check_after_create=true.",
     parameters: params,
     async execute(_toolCallId, args) {
         const db = initDefaultDatabase();
@@ -278,6 +296,62 @@ export const alertsTool = {
                     details: rule,
                 };
             }
+            if (args.action === "update") {
+                if (args.id == null) {
+                    throw new Error("id is required for update.");
+                }
+                const existing = service.listAlertRules().find((rule) => rule.id === args.id);
+                if (existing == null) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Alert #${args.id} not found. Use the list action to see alert ids.`,
+                            },
+                        ],
+                        details: null,
+                    };
+                }
+                const conditionAction = args.condition_action ?? createActionFromRule(existing);
+                if (conditionAction == null) {
+                    throw new Error(`Alert #${args.id} uses condition ${existing.conditionType}, which cannot be updated without condition_action.`);
+                }
+                const payload = await buildAlertRulePayload(service, conditionAction, args, existing);
+                if (payload.status === "needs_selection")
+                    return candidateResult(payload.resolution, "alert");
+                const rule = service.updateAlertRule(args.id, {
+                    ...payload.input,
+                    enabled: args.enabled,
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: rule == null
+                                ? `Alert #${args.id} not found. Use the list action to see alert ids.`
+                                : `Updated alert #${rule.id}.`,
+                        },
+                    ],
+                    details: rule,
+                };
+            }
+            if (args.action === "delete") {
+                if (args.id == null) {
+                    throw new Error("id is required for delete.");
+                }
+                const rule = service.deleteAlertRule(args.id);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: rule == null
+                                ? `Alert #${args.id} not found. Use the list action to see alert ids.`
+                                : `Deleted alert #${rule.id}.`,
+                        },
+                    ],
+                    details: rule,
+                };
+            }
             const result = await checkAlerts(service);
             return {
                 content: [{ type: "text", text: result.lines.join("\n") }],
@@ -289,6 +363,159 @@ export const alertsTool = {
         }
     },
 };
+async function buildAlertRulePayload(service, action, args, existing) {
+    const instrument = await resolveAlertInstrument(service, args.symbol, existing);
+    if (instrument.status === "needs_selection")
+        return instrument;
+    const existingCondition = conditionRecord(existing);
+    const cooldownSeconds = args.cooldown_seconds === undefined
+        ? undefined
+        : validateCooldownSeconds(args.cooldown_seconds);
+    const base = {
+        scopeType: "instrument",
+        instrumentId: instrument.id,
+        conditionVersion: ALERT_CONDITION_VERSION,
+        cooldownSeconds,
+    };
+    if (action === "create_price_above" || action === "create_price_below") {
+        const threshold = numberInput(args.threshold, existingCondition, "threshold", "threshold");
+        const isAbove = action === "create_price_above";
+        return {
+            status: "ok",
+            input: {
+                ...base,
+                conditionType: isAbove ? "price_crosses_above" : "price_crosses_below",
+                condition: isAbove ? priceCrossesAbove(threshold) : priceCrossesBelow(threshold),
+                timeframe: "quote",
+            },
+        };
+    }
+    if (action === "create_price_above_sma" || action === "create_price_below_sma") {
+        const period = validateLookbackPeriod(numberInput(args.period, existingCondition, "period", "period", 50), 200);
+        return {
+            status: "ok",
+            input: {
+                ...base,
+                conditionType: "price_crosses_sma",
+                condition: priceCrossesSma(period, action === "create_price_above_sma" ? "above" : "below"),
+                timeframe: "1d",
+            },
+        };
+    }
+    if (action === "create_rsi_above" || action === "create_rsi_below") {
+        const threshold = numberInput(args.threshold, existingCondition, "threshold", "threshold");
+        const period = validateLookbackPeriod(numberInput(args.period, existingCondition, "period", "period", 14), 100);
+        return {
+            status: "ok",
+            input: {
+                ...base,
+                conditionType: "rsi_threshold",
+                condition: rsiThreshold(period, threshold, action === "create_rsi_above" ? "above" : "below"),
+                timeframe: "1d",
+            },
+        };
+    }
+    if (action === "create_volume_spike") {
+        const period = validateLookbackPeriod(numberInput(args.period, existingCondition, "lookback_period", "period", 20), 100);
+        const multiplier = numberInput(args.threshold, existingCondition, "multiplier", "threshold", 2);
+        return {
+            status: "ok",
+            input: {
+                ...base,
+                conditionType: "volume_spike",
+                condition: volumeSpike(period, multiplier),
+                timeframe: "1d",
+            },
+        };
+    }
+    if (action === "create_percent_move_up" || action === "create_percent_move_down") {
+        const threshold = numberInput(args.threshold, existingCondition, "percent", "threshold");
+        if (threshold <= 0) {
+            throw new Error("threshold must be greater than 0 for percent-move alert actions.");
+        }
+        return {
+            status: "ok",
+            input: {
+                ...base,
+                conditionType: "percent_move",
+                condition: percentMove(action === "create_percent_move_up" ? "up" : "down", threshold),
+                timeframe: "1d",
+            },
+        };
+    }
+    const fastPeriod = numberInput(args.fast_period, existingCondition, "fast_period", "fast_period", 50);
+    const slowPeriod = numberInput(args.slow_period, existingCondition, "slow_period", "slow_period", 200);
+    if (!Number.isInteger(fastPeriod) || !Number.isInteger(slowPeriod)) {
+        throw new Error("fast_period and slow_period must be whole-number lookback periods for SMA-cross alert actions.");
+    }
+    if (fastPeriod <= 0 || slowPeriod <= 0) {
+        throw new Error("fast_period and slow_period must be greater than 0 for SMA-cross alert actions.");
+    }
+    if (fastPeriod >= slowPeriod) {
+        throw new Error("fast_period must be less than slow_period for SMA-cross alert actions.");
+    }
+    if (slowPeriod > 400) {
+        throw new Error("slow_period must be at most 400 so alert checks can evaluate it against the runner's 2y daily history window.");
+    }
+    return {
+        status: "ok",
+        input: {
+            ...base,
+            conditionType: "sma_cross",
+            condition: smaCross(fastPeriod, slowPeriod, action === "create_sma_cross_above" ? "above" : "below"),
+            timeframe: "1d",
+        },
+    };
+}
+async function resolveAlertInstrument(service, symbol, existing) {
+    if (symbol) {
+        const resolution = await resolveInstrumentForMutation(symbol);
+        if (resolution.status === "needs_selection")
+            return { status: "needs_selection", resolution };
+        return { status: "ok", id: service.upsertInstrumentRecord(resolution.instrument).id };
+    }
+    if (existing?.instrumentId != null)
+        return { status: "ok", id: existing.instrumentId };
+    throw new Error("symbol is required for update when the existing alert is not instrument-scoped.");
+}
+function conditionRecord(rule) {
+    return typeof rule?.conditionJson === "object" && rule.conditionJson !== null
+        ? rule.conditionJson
+        : {};
+}
+function numberInput(value, existing, existingKey, label, fallback) {
+    if (value !== undefined)
+        return value;
+    const existingValue = existing[existingKey];
+    if (typeof existingValue === "number")
+        return existingValue;
+    if (fallback !== undefined)
+        return fallback;
+    throw new Error(`${label} is required for update.`);
+}
+function createActionFromRule(rule) {
+    const condition = conditionRecord(rule);
+    const direction = condition.direction;
+    if (rule.conditionType === "price_crosses_above")
+        return "create_price_above";
+    if (rule.conditionType === "price_crosses_below")
+        return "create_price_below";
+    if (rule.conditionType === "price_crosses_sma") {
+        return direction === "below" ? "create_price_below_sma" : "create_price_above_sma";
+    }
+    if (rule.conditionType === "rsi_threshold") {
+        return direction === "below" ? "create_rsi_below" : "create_rsi_above";
+    }
+    if (rule.conditionType === "volume_spike")
+        return "create_volume_spike";
+    if (rule.conditionType === "percent_move") {
+        return direction === "down" ? "create_percent_move_down" : "create_percent_move_up";
+    }
+    if (rule.conditionType === "sma_cross") {
+        return direction === "below" ? "create_sma_cross_below" : "create_sma_cross_above";
+    }
+    return null;
+}
 function validateLookbackPeriod(period, maxPeriod) {
     if (!Number.isInteger(period) || period <= 0) {
         throw new Error("period must be a whole-number lookback period greater than 0 for indicator alert actions.");
@@ -354,4 +581,3 @@ async function createResultMaybeChecked(service, rule, createdText, checkAfterCr
         },
     };
 }
-//# sourceMappingURL=alerts.js.map