opencandle 0.5.0 → 0.6.0

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

@@ -1,9 +1,10 @@
 import { Type } from "@sinclair/typebox";
-import { getOptionsChain } from "../../providers/yahoo-finance.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
+import { getOptionsChain } from "../../providers/yahoo-finance.js";
 const params = Type.Object({
     symbol: Type.String({ description: "Stock ticker symbol (e.g. AAPL, TSLA, SPY, MSFT)" }),
     expiration: Type.Optional(Type.String({
+        pattern: "^\\d{4}-\\d{2}-\\d{2}$",
         description: "Expiration date as YYYY-MM-DD. If omitted, uses the nearest expiration.",
     })),
     type: Type.Optional(Type.Union([Type.Literal("call"), Type.Literal("put"), Type.Literal("CALL"), Type.Literal("PUT")], {
@@ -18,13 +19,13 @@ export const optionChainTool = {
     async execute(_toolCallId, args) {
         const symbol = args.symbol.toUpperCase();
         const normalizedType = args.type?.toLowerCase();
-        const expirationTs = args.expiration
-            ? Math.floor(new Date(args.expiration).getTime() / 1000)
-            : undefined;
+        const expirationTs = args.expiration ? parseExpiration(args.expiration) : undefined;
         const result = await wrapProvider("yahoo", () => getOptionsChain(symbol, expirationTs));
         if (result.status === "unavailable") {
             return {
-                content: [{ type: "text", text: `⚠ Options chain unavailable for ${symbol} (${result.reason}).` }],
+                content: [
+                    { type: "text", text: `⚠ Options chain unavailable for ${symbol} (${result.reason}).` },
+                ],
                 details: null,
             };
         }
@@ -35,7 +36,9 @@ export const optionChainTool = {
             `Quote status: ${chain.quoteStatus.marketSession} / ${chain.quoteStatus.bidAskState}`,
             "Option bid/ask and last prices are quoted per share; multiply by 100 for one standard contract premium.",
             ...(chain.quoteStatus.warning
-                ? [`⚠ ${chain.quoteStatus.warning} do not treat zero bid/ask as confirmed live illiquidity without broker verification; do not stop at the stale quote caveat. Disclose the gap, avoid naming tradable live premiums, and finish the strategy explanation with mechanics, assignment outcomes, labeled hypotheticals, and what live broker quotes would change.`]
+                ? [
+                    `⚠ ${chain.quoteStatus.warning} do not treat zero bid/ask as confirmed live illiquidity without broker verification; do not stop at the stale quote caveat. Disclose the gap, avoid naming tradable live premiums, and finish the strategy explanation with mechanics, assignment outcomes, labeled hypotheticals, and what live broker quotes would change.`,
+                ]
                 : []),
             `Available expirations: ${formatAvailableExpirations(chain.expirationDates)}`,
             "",
@@ -64,6 +67,16 @@ export const optionChainTool = {
         return { content: [{ type: "text", text: lines.join("\n") }], details: chain };
     },
 };
+function parseExpiration(expiration) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(expiration)) {
+        throw new Error("expiration must be a valid YYYY-MM-DD date.");
+    }
+    const parsed = new Date(`${expiration}T00:00:00.000Z`);
+    if (Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== expiration) {
+        throw new Error("expiration must be a valid YYYY-MM-DD date.");
+    }
+    return Math.floor(parsed.getTime() / 1000);
+}
 function sortByVolume(contracts) {
     return [...contracts].sort((a, b) => b.volume - a.volume);
 }

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

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

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

@@ -0,0 +1,15 @@
+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">]>;
+    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>;
+    enabled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    check_after_create: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export declare const alertsTool: AgentTool<typeof params>;
+export {};

package/dist/tools/portfolio/alerts.js

@@ -0,0 +1,357 @@
+import { Type } from "@sinclair/typebox";
+import { ALERT_CONDITION_VERSION, percentMove, priceCrossesAbove, priceCrossesBelow, priceCrossesSma, rsiThreshold, smaCross, volumeSpike, } from "../../market-state/alert-conditions.js";
+import { defaultAlertRunnerProviders, runAlertChecks } from "../../market-state/alert-runner.js";
+import { deliverPendingNotifications } from "../../market-state/notification-delivery.js";
+import { resolveInstrumentForMutation } from "../../market-state/resolve-for-mutation.js";
+import { MarketStateService } from "../../market-state/service.js";
+import { initDefaultDatabase } from "../../memory/sqlite.js";
+const ACTION_DESCRIPTION = [
+    "One of: 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, check.",
+    "Use create_price_above/create_price_below for price alerts,",
+    "create_price_above_sma/create_price_below_sma for SMA crossing alerts,",
+    "create_percent_move_up/create_percent_move_down for one-day percent move alerts,",
+    "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,",
+    "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.",
+].join(" ");
+const params = Type.Object({
+    action: 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"),
+        Type.Literal("set_enabled"),
+        Type.Literal("list"),
+        Type.Literal("status"),
+        Type.Literal("check"),
+    ], { description: ACTION_DESCRIPTION }),
+    symbol: Type.Optional(Type.String({ description: "Ticker symbol for create actions" })),
+    threshold: Type.Optional(Type.Number({ description: "Price or indicator threshold for create actions" })),
+    period: Type.Optional(Type.Integer({
+        minimum: 1,
+        description: "Indicator lookback period for SMA/RSI alerts. Max: 200 for price-SMA, 100 for RSI/volume alerts",
+    })),
+    fast_period: Type.Optional(Type.Integer({
+        minimum: 1,
+        description: "Fast SMA lookback period for SMA-cross alerts. Default: 50",
+    })),
+    slow_period: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 400,
+        description: "Slow SMA lookback period for SMA-cross alerts. Default: 200, max: 400",
+    })),
+    cooldown_seconds: Type.Optional(Type.Integer({
+        minimum: 0,
+        description: "Cooldown between repeated trigger events. Default: 3600",
+    })),
+    id: Type.Optional(Type.Number({ description: "Alert rule id for update actions" })),
+    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.",
+    })),
+});
+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.",
+    parameters: params,
+    async execute(_toolCallId, args) {
+        const db = initDefaultDatabase();
+        const service = new MarketStateService(db);
+        try {
+            const cooldownSeconds = validateCooldownSeconds(args.cooldown_seconds);
+            if (args.action === "create_price_above" || args.action === "create_price_below") {
+                if (!args.symbol || args.threshold == null) {
+                    throw new Error("symbol and threshold are required for create alert actions.");
+                }
+                const resolution = await resolveInstrumentForMutation(args.symbol);
+                if (resolution.status === "needs_selection")
+                    return candidateResult(resolution, "alert");
+                const instrument = service.upsertInstrumentRecord(resolution.instrument);
+                const isAbove = args.action === "create_price_above";
+                const rule = service.createAlertRule({
+                    scopeType: "instrument",
+                    instrumentId: instrument.id,
+                    conditionType: isAbove ? "price_crosses_above" : "price_crosses_below",
+                    conditionVersion: ALERT_CONDITION_VERSION,
+                    condition: isAbove
+                        ? priceCrossesAbove(args.threshold)
+                        : priceCrossesBelow(args.threshold),
+                    timeframe: "quote",
+                    cooldownSeconds,
+                });
+                return await createResultMaybeChecked(service, rule, `Created local alert ${rule.conditionType} for ${instrument.symbol} at $${args.threshold}.`, args.check_after_create);
+            }
+            if (args.action === "create_price_above_sma" || args.action === "create_price_below_sma") {
+                if (!args.symbol) {
+                    throw new Error("symbol is required for SMA alert actions.");
+                }
+                // Runner evaluates price_crosses_sma against 1y of daily bars (~252).
+                const period = validateLookbackPeriod(args.period ?? 50, 200);
+                const resolution = await resolveInstrumentForMutation(args.symbol);
+                if (resolution.status === "needs_selection")
+                    return candidateResult(resolution, "alert");
+                const instrument = service.upsertInstrumentRecord(resolution.instrument);
+                const direction = args.action === "create_price_above_sma" ? "above" : "below";
+                const rule = service.createAlertRule({
+                    scopeType: "instrument",
+                    instrumentId: instrument.id,
+                    conditionType: "price_crosses_sma",
+                    conditionVersion: ALERT_CONDITION_VERSION,
+                    condition: priceCrossesSma(period, direction),
+                    timeframe: "1d",
+                    cooldownSeconds,
+                });
+                return await createResultMaybeChecked(service, rule, `Created local alert price_crosses_sma for ${instrument.symbol} using SMA(${period}).`, args.check_after_create);
+            }
+            if (args.action === "create_rsi_above" || args.action === "create_rsi_below") {
+                if (!args.symbol || args.threshold == null) {
+                    throw new Error("symbol and threshold are required for RSI alert actions.");
+                }
+                // Runner evaluates rsi_threshold against 6mo of daily bars (~126).
+                const period = validateLookbackPeriod(args.period ?? 14, 100);
+                const resolution = await resolveInstrumentForMutation(args.symbol);
+                if (resolution.status === "needs_selection")
+                    return candidateResult(resolution, "alert");
+                const instrument = service.upsertInstrumentRecord(resolution.instrument);
+                const direction = args.action === "create_rsi_above" ? "above" : "below";
+                const rule = service.createAlertRule({
+                    scopeType: "instrument",
+                    instrumentId: instrument.id,
+                    conditionType: "rsi_threshold",
+                    conditionVersion: ALERT_CONDITION_VERSION,
+                    condition: rsiThreshold(period, args.threshold, direction),
+                    timeframe: "1d",
+                    cooldownSeconds,
+                });
+                return await createResultMaybeChecked(service, rule, `Created local alert rsi_threshold for ${instrument.symbol}: RSI(${period}) ${direction} ${args.threshold}.`, args.check_after_create);
+            }
+            if (args.action === "create_volume_spike") {
+                if (!args.symbol) {
+                    throw new Error("symbol is required for volume-spike alert actions.");
+                }
+                // Runner evaluates volume_spike against 6mo of daily bars (~126).
+                const period = validateLookbackPeriod(args.period ?? 20, 100);
+                const multiplier = args.threshold ?? 2;
+                const resolution = await resolveInstrumentForMutation(args.symbol);
+                if (resolution.status === "needs_selection")
+                    return candidateResult(resolution, "alert");
+                const instrument = service.upsertInstrumentRecord(resolution.instrument);
+                const rule = service.createAlertRule({
+                    scopeType: "instrument",
+                    instrumentId: instrument.id,
+                    conditionType: "volume_spike",
+                    conditionVersion: ALERT_CONDITION_VERSION,
+                    condition: volumeSpike(period, multiplier),
+                    timeframe: "1d",
+                    cooldownSeconds,
+                });
+                return await createResultMaybeChecked(service, rule, `Created local alert volume_spike for ${instrument.symbol}: volume > ${multiplier}x ${period}-bar average.`, args.check_after_create);
+            }
+            if (args.action === "create_percent_move_up" || args.action === "create_percent_move_down") {
+                if (!args.symbol || args.threshold == null) {
+                    throw new Error("symbol and threshold are required for percent-move alert actions.");
+                }
+                if (args.threshold <= 0) {
+                    throw new Error("threshold must be greater than 0 for percent-move alert actions.");
+                }
+                const resolution = await resolveInstrumentForMutation(args.symbol);
+                if (resolution.status === "needs_selection")
+                    return candidateResult(resolution, "alert");
+                const instrument = service.upsertInstrumentRecord(resolution.instrument);
+                const direction = args.action === "create_percent_move_up" ? "up" : "down";
+                const rule = service.createAlertRule({
+                    scopeType: "instrument",
+                    instrumentId: instrument.id,
+                    conditionType: "percent_move",
+                    conditionVersion: ALERT_CONDITION_VERSION,
+                    condition: percentMove(direction, args.threshold),
+                    timeframe: "1d",
+                    cooldownSeconds,
+                });
+                return await createResultMaybeChecked(service, rule, `Created local alert percent_move for ${instrument.symbol}: ${direction} ${args.threshold}%.`, args.check_after_create);
+            }
+            if (args.action === "create_sma_cross_above" || args.action === "create_sma_cross_below") {
+                if (!args.symbol) {
+                    throw new Error("symbol is required for SMA-cross alert actions.");
+                }
+                const fastPeriod = args.fast_period ?? 50;
+                const slowPeriod = args.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.");
+                }
+                // Runner evaluates sma_cross against 2y of daily bars (~504).
+                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.");
+                }
+                const resolution = await resolveInstrumentForMutation(args.symbol);
+                if (resolution.status === "needs_selection")
+                    return candidateResult(resolution, "alert");
+                const instrument = service.upsertInstrumentRecord(resolution.instrument);
+                const direction = args.action === "create_sma_cross_above" ? "above" : "below";
+                const rule = service.createAlertRule({
+                    scopeType: "instrument",
+                    instrumentId: instrument.id,
+                    conditionType: "sma_cross",
+                    conditionVersion: ALERT_CONDITION_VERSION,
+                    condition: smaCross(fastPeriod, slowPeriod, direction),
+                    timeframe: "1d",
+                    cooldownSeconds,
+                });
+                return await createResultMaybeChecked(service, rule, `Created local alert sma_cross for ${instrument.symbol}: SMA(${fastPeriod}) crosses ${direction} SMA(${slowPeriod}).`, args.check_after_create);
+            }
+            if (args.action === "list") {
+                const rules = service.listAlertRules();
+                if (rules.length === 0) {
+                    return { content: [{ type: "text", text: "No alert rules created yet." }], details: [] };
+                }
+                const lines = ["**Alerts** — local runner eligible; manual checks available", ""];
+                for (const rule of rules) {
+                    const instrument = rule.instrumentId == null ? null : service.getInstrument(rule.instrumentId);
+                    lines.push(`  #${rule.id} ${instrument?.symbol ?? "watchlist"} ${rule.conditionType} (${rule.enabled ? "enabled" : "disabled"})`);
+                }
+                return { content: [{ type: "text", text: lines.join("\n") }], details: rules };
+            }
+            if (args.action === "status") {
+                const runnerLease = service.getAutomationRunnerLease();
+                const recentCheckRuns = service.listAlertCheckRuns().slice(0, 10);
+                const stateLine = runnerLease
+                    ? `Running locally — ${runnerLease.ownerKind} ${runnerLease.ownerId}; heartbeat ${runnerLease.heartbeatAt}; expires ${runnerLease.expiresAt}.`
+                    : "Manual only — no active local runner lease. Keep the GUI/TUI writer or `opencandle monitor` open for background checks.";
+                const lines = ["**Alert Automation Status**", "", stateLine];
+                if (recentCheckRuns.length === 0) {
+                    lines.push("", "No alert check runs yet.");
+                }
+                else {
+                    lines.push("", "Recent checks:");
+                    for (const run of recentCheckRuns) {
+                        lines.push(`  #${run.id} ${run.triggerType} ${run.status} checked=${run.checkedCount} triggered=${run.triggeredCount} unavailable=${run.unavailableCount}`);
+                    }
+                }
+                return {
+                    content: [{ type: "text", text: lines.join("\n") }],
+                    details: { runnerLease, recentCheckRuns },
+                };
+            }
+            if (args.action === "set_enabled") {
+                if (args.id == null || args.enabled == null) {
+                    throw new Error("id and enabled are required for set_enabled.");
+                }
+                const rule = service.setAlertRuleEnabled(args.id, args.enabled);
+                if (rule == null) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Alert #${args.id} not found. Use the list action to see alert ids.`,
+                            },
+                        ],
+                        details: null,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${rule.enabled ? "Enabled" : "Disabled"} alert #${rule.id}.`,
+                        },
+                    ],
+                    details: rule,
+                };
+            }
+            const result = await checkAlerts(service);
+            return {
+                content: [{ type: "text", text: result.lines.join("\n") }],
+                details: result,
+            };
+        }
+        finally {
+            db.close();
+        }
+    },
+};
+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.");
+    }
+    if (period > maxPeriod) {
+        throw new Error(`period must be at most ${maxPeriod} so alert checks can evaluate it against the runner's daily history window.`);
+    }
+    return period;
+}
+function validateCooldownSeconds(cooldownSeconds) {
+    const resolved = cooldownSeconds ?? 3600;
+    if (!Number.isInteger(resolved) || resolved < 0) {
+        throw new Error("cooldown_seconds must be a whole number greater than or equal to 0.");
+    }
+    return resolved;
+}
+async function checkAlerts(service) {
+    const enabled = service
+        .listAlertRules()
+        .filter((rule) => rule.enabled && rule.status === "active");
+    if (enabled.length === 0)
+        return { checked: 0, triggered: 0, lines: ["No enabled alert rules to check."] };
+    const result = await runAlertChecks(service, {
+        ownerId: "manual-tool",
+        triggerType: "manual",
+        providers: defaultAlertRunnerProviders,
+    });
+    await deliverPendingNotifications(service);
+    return {
+        checked: result.checked,
+        triggered: result.triggered,
+        lines: [
+            `**Manual Alert Check** — ${enabled.length} rule(s)`,
+            "",
+            ...result.lines.map((line) => `  ${line}`),
+        ],
+    };
+}
+function candidateResult(resolution, target) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Could not verify ${resolution.query}. Choose one of the returned candidates before creating the ${target}.`,
+            },
+        ],
+        details: resolution,
+    };
+}
+async function createResultMaybeChecked(service, rule, createdText, checkAfterCreate) {
+    if (!checkAfterCreate) {
+        return {
+            content: [{ type: "text", text: createdText }],
+            details: rule,
+        };
+    }
+    const check = await checkAlerts(service);
+    return {
+        content: [{ type: "text", text: `${createdText}\n\n${check.lines.join("\n")}` }],
+        details: {
+            created: rule,
+            check,
+        },
+    };
+}
+//# sourceMappingURL=alerts.js.map

package/dist/tools/portfolio/alerts.js.map

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

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

@@ -4,7 +4,7 @@ export declare function computeCorrelation(returnsA: number[], returnsB: number[
 export declare function alignReturnsByDate(historiesBySymbol: Map<string, OHLCV[]>, minOverlap?: number): Map<string, number[]>;
 declare const params: import("@sinclair/typebox").TObject<{
     symbols: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    period: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"6mo" | "1y" | "2y">[]>>;
 }>;
 export declare const correlationTool: AgentTool<typeof params>;
 export {};

package/dist/tools/portfolio/correlation.js

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
-import { getHistory } from "../../providers/yahoo-finance.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
+import { getHistory } from "../../providers/yahoo-finance.js";
 import { computeDailyReturns } from "./risk-analysis.js";
 export function computeCorrelation(returnsA, returnsB) {
     const n = Math.min(returnsA.length, returnsB.length);
@@ -26,6 +26,7 @@ export function computeCorrelation(returnsA, returnsB) {
     return cov / Math.sqrt(varA * varB);
 }
 const DEFAULT_MIN_OVERLAP = 20;
+const CORRELATION_PERIODS = ["6mo", "1y", "2y"];
 export function alignReturnsByDate(historiesBySymbol, minOverlap = DEFAULT_MIN_OVERLAP) {
     // Build date → close price maps for each symbol
     const priceByDate = new Map();
@@ -39,7 +40,9 @@ export function alignReturnsByDate(historiesBySymbol, minOverlap = DEFAULT_MIN_O
     // Find common dates across all symbols
     const symbols = [...historiesBySymbol.keys()];
     const firstDates = priceByDate.get(symbols[0]);
-    const commonDates = [...firstDates.keys()].filter((date) => symbols.every((s) => priceByDate.get(s).has(date))).sort();
+    const commonDates = [...firstDates.keys()]
+        .filter((date) => symbols.every((s) => priceByDate.get(s).has(date)))
+        .sort();
     if (commonDates.length < minOverlap) {
         throw new Error(`Insufficient date overlap for correlation: ${commonDates.length} common dates (need ${minOverlap}+). Symbols may trade on different exchanges or have sparse history.`);
     }
@@ -57,12 +60,14 @@ const params = Type.Object({
         description: "Array of 2+ ticker symbols to compute correlation matrix (e.g. ['AAPL','MSFT','GOOGL'])",
         minItems: 2,
     }),
-    period: Type.Optional(Type.String({ description: "Historical period: 6mo, 1y, 2y. Default: 1y" })),
+    period: Type.Optional(Type.Union(CORRELATION_PERIODS.map((period) => Type.Literal(period)), {
+        description: "Historical period: 6mo, 1y, 2y. Default: 1y",
+    })),
 });
 export const correlationTool = {
     name: "analyze_correlation",
     label: "Correlation Matrix",
-    description: "Compute pairwise return correlations between 2+ stocks. Identifies highly correlated positions (|r| > 0.7) as concentration risk. Useful for portfolio diversification analysis.",
+    description: "Compute pairwise return correlations between 2+ stocks. If one symbol cannot be fetched, computes over the remaining 2+ symbols and lists dropped symbols. Identifies highly correlated positions (|r| > 0.7) as concentration risk. Useful for portfolio diversification analysis.",
     parameters: params,
     async execute(_toolCallId, args) {
         const symbols = args.symbols.map((s) => s.toUpperCase());
@@ -75,10 +80,19 @@ export const correlationTool = {
             symbol: s,
             result: await wrapProvider("yahoo", () => getHistory(s, period, "1d")),
         })));
-        const unavailable = results.filter((r) => r.result.status === "unavailable");
-        if (unavailable.length === results.length) {
+        const dropped = results.flatMap((r) => r.result.status === "unavailable" ? [{ symbol: r.symbol, reason: r.result.reason }] : []);
+        const succeeded = results.filter((r) => r.result.status === "ok");
+        if (succeeded.length < 2) {
+            const droppedText = dropped.length > 0
+                ? `\n\nSymbols dropped:\n${dropped.map((d) => `  - ${d.symbol}: ${d.reason}`).join("\n")}`
+                : "";
             return {
-                content: [{ type: "text", text: `⚠ Correlation analysis unavailable — could not fetch history for any symbol.` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `⚠ Correlation analysis unavailable — need at least 2 symbols with usable history.${droppedText}`,
+                    },
+                ],
                 details: null,
             };
         }
@@ -88,12 +102,13 @@ export const correlationTool = {
                 historiesBySymbol.set(sym, r.data);
         }
         const returnsBySymbol = alignReturnsByDate(historiesBySymbol);
+        const survivorSymbols = [...historiesBySymbol.keys()];
         // Build correlation matrix
         const matrix = {};
         const warnings = [];
-        for (const a of symbols) {
+        for (const a of survivorSymbols) {
             matrix[a] = {};
-            for (const b of symbols) {
+            for (const b of survivorSymbols) {
                 if (a === b) {
                     matrix[a][b] = 1.0;
                 }
@@ -111,12 +126,17 @@ export const correlationTool = {
         }
         // Format output
         const header = `**Correlation Matrix** (${period} daily returns)`;
-        const colHeader = `${"".padEnd(8)} ${symbols.map((s) => s.padStart(8)).join("")}`;
-        const rows = symbols.map((a) => {
-            const cells = symbols.map((b) => matrix[a][b].toFixed(2).padStart(8));
+        const colHeader = `${"".padEnd(8)} ${survivorSymbols.map((s) => s.padStart(8)).join("")}`;
+        const rows = survivorSymbols.map((a) => {
+            const cells = survivorSymbols.map((b) => matrix[a][b].toFixed(2).padStart(8));
             return `${a.padEnd(8)} ${cells.join("")}`;
         });
         const lines = [header, "", colHeader, ...rows];
+        if (dropped.length > 0) {
+            lines.push("", "Symbols dropped:");
+            for (const drop of dropped)
+                lines.push(`  - ${drop.symbol}: ${drop.reason}`);
+        }
         if (warnings.length > 0) {
             lines.push("", "**Concentration Warnings:**");
             for (const w of warnings)
@@ -127,7 +147,7 @@ export const correlationTool = {
         }
         return {
             content: [{ type: "text", text: lines.join("\n") }],
-            details: { matrix, warnings },
+            details: { matrix, warnings, dropped },
         };
     },
 };