opencandle 0.11.1 → 0.13.0

package/dist/pi/setup.js

@@ -1,4 +1,5 @@
 import { LoginDialogComponent, } from "@earendil-works/pi-coding-agent";
+import { validateModelKey } from "../onboarding/validate-model-key.js";
 /**
  * Registry of "fast default" models for each LLM auth provider. After a fresh
  * sign-in we try to activate the default without opening a picker, falling back
@@ -82,8 +83,8 @@ async function selectProviderForLogin(ctx) {
             return undefined;
     }
 }
-async function selectAdvancedOAuthProvider(ctx) {
-    const providers = ctx.modelRegistry.authStorage.getOAuthProviders();
+async function selectAdvancedOAuthProvider(ctx, modelRuntime) {
+    const providers = modelRuntime.getProviders().filter((provider) => provider.auth.oauth?.login);
     if (providers.length === 0) {
         ctx.ui.notify("No sign-in providers are available.", "warning");
         return undefined;
@@ -92,12 +93,9 @@ async function selectAdvancedOAuthProvider(ctx) {
     const choice = await ctx.ui.select("Choose a provider", labels);
     return providers.find((provider) => provider.name === choice)?.id;
 }
-async function runLoginDialog(ctx, providerId) {
-    const provider = ctx.modelRegistry.authStorage
-        .getOAuthProviders()
-        .find((item) => item.id === providerId);
+async function runLoginDialog(ctx, providerId, modelRuntime) {
+    const provider = modelRuntime.getProvider(providerId);
     const providerName = provider?.name ?? providerId;
-    const usesCallbackServer = provider?.usesCallbackServer ?? false;
     const success = await ctx.ui.custom((tui, _theme, _keybindings, done) => {
         let finished = false;
         const finish = (value) => {
@@ -109,52 +107,34 @@ async function runLoginDialog(ctx, providerId) {
         const dialog = new LoginDialogComponent(tui, providerId, (completed) => {
             finish(completed);
         });
-        let manualCodeResolve;
-        let manualCodeReject;
-        const manualCodePromise = new Promise((resolve, reject) => {
-            manualCodeResolve = resolve;
-            manualCodeReject = reject;
-        });
-        // Cast required: advanced providers return dynamic IDs outside the SDK's static union type
-        void ctx.modelRegistry.authStorage
-            .login(providerId, {
-            onAuth: (info) => {
-                dialog.showAuth(info.url, info.instructions);
-                if (usesCallbackServer) {
-                    void dialog
-                        .showManualInput("Paste redirect URL below, or complete login in your browser:")
-                        .then((value) => {
-                        if (value && manualCodeResolve) {
-                            manualCodeResolve(value);
-                            manualCodeResolve = undefined;
-                        }
-                    })
-                        .catch(() => {
-                        if (manualCodeReject) {
-                            manualCodeReject(new Error("Login cancelled"));
-                            manualCodeReject = undefined;
-                        }
-                    });
-                }
-                else if (providerId === "github-copilot") {
-                    dialog.showWaiting("Waiting for browser authentication...");
-                }
-            },
-            onDeviceCode: (info) => {
-                dialog.showDeviceCode(info);
-                dialog.showWaiting("Waiting for authentication...");
-            },
-            onPrompt: async (prompt) => dialog.showPrompt(prompt.message, prompt.placeholder),
-            onProgress: (message) => dialog.showProgress(message),
-            onSelect: async (prompt) => {
-                const options = prompt.options
+        const prompt = async (request) => {
+            if (request.type === "select") {
+                const options = request.options
                     .map((option, index) => `${index + 1}. ${option.label}`)
                     .join("\n");
-                const answer = await dialog.showPrompt(`${prompt.message}\n\n${options}`, "Enter a number");
+                const answer = await dialog.showPrompt(`${request.message}\n\n${options}`, "Enter a number");
                 const selectedIndex = Number.parseInt(answer.trim(), 10) - 1;
-                return prompt.options[selectedIndex]?.id;
-            },
-            onManualCodeInput: () => manualCodePromise,
+                return request.options[selectedIndex]?.id ?? "";
+            }
+            return dialog.showPrompt(request.message, request.placeholder);
+        };
+        const notify = (event) => {
+            if (event.type === "auth_url")
+                dialog.showAuth(event.url, event.instructions);
+            else if (event.type === "device_code") {
+                dialog.showDeviceCode({
+                    userCode: event.userCode,
+                    verificationUri: event.verificationUri,
+                });
+                dialog.showWaiting("Waiting for authentication...");
+            }
+            else if (event.type === "progress" || event.type === "info")
+                dialog.showProgress(event.message);
+        };
+        void modelRuntime
+            .login(providerId, "oauth", {
+            prompt,
+            notify,
             signal: dialog.signal,
         })
             .then(() => finish(true))
@@ -174,7 +154,7 @@ async function runLoginDialog(ctx, providerId) {
     }
     return false;
 }
-async function runApiKeySetup(ctx, provider) {
+export async function runApiKeySetup(ctx, provider, modelRuntime) {
     const label = API_KEY_PROVIDER_LABELS[provider];
     ctx.ui.notify(`OpenCandle stores your ${label} API key locally. After saving it, OpenCandle will select a fast default model when one is available.`, "info");
     const key = await ctx.ui.input(`Paste your ${label} API key`, "API key");
@@ -183,9 +163,19 @@ async function runApiKeySetup(ctx, provider) {
         ctx.ui.notify("No API key entered.", "warning");
         return false;
     }
-    ctx.modelRegistry.authStorage.set(provider, { type: "api_key", key: trimmed });
-    ctx.modelRegistry.refresh();
-    ctx.ui.notify(`${label} API key saved to OpenCandle.`, "info");
+    const validation = await validateModelKey(provider, trimmed);
+    if (validation.status === "invalid") {
+        ctx.ui.notify(`Key was rejected by ${validation.providerLabel}. Paste a different key.`, "error");
+        return false;
+    }
+    await modelRuntime.login(provider, "api_key", {
+        prompt: async () => trimmed,
+        notify: () => { },
+    });
+    await ctx.modelRegistry.refresh();
+    ctx.ui.notify(validation.status === "transient"
+        ? `Saved — couldn't verify (network issue). ${label} API key saved to OpenCandle.`
+        : `${label} API key saved to OpenCandle.`, "info");
     return true;
 }
 /**
@@ -236,7 +226,7 @@ async function selectModel(api, ctx, preferredProvider) {
     ctx.ui.notify(`Model selected: ${model.provider}/${model.id}`, "info");
     return true;
 }
-async function runLlmSetup(api, ctx, mode) {
+async function runLlmSetup(api, ctx, mode, modelRuntime) {
     while (true) {
         const requirement = getLlmSetupRequirement(ctx);
         if (requirement === "ready") {
@@ -268,15 +258,21 @@ async function runLlmSetup(api, ctx, mode) {
             return "cancelled";
         }
         if (choice === "Sign in with browser") {
+            if (!modelRuntime) {
+                ctx.ui.notify("Model authentication is unavailable in this session.", "error");
+                return "cancelled";
+            }
             const providerChoice = await selectProviderForLogin(ctx);
             if (!providerChoice) {
                 continue;
             }
-            const providerId = providerChoice === "advanced" ? await selectAdvancedOAuthProvider(ctx) : providerChoice;
+            const providerId = providerChoice === "advanced"
+                ? await selectAdvancedOAuthProvider(ctx, modelRuntime)
+                : providerChoice;
             if (!providerId) {
                 continue;
             }
-            const loggedIn = await runLoginDialog(ctx, providerId);
+            const loggedIn = await runLoginDialog(ctx, providerId, modelRuntime);
             if (!loggedIn) {
                 continue;
             }
@@ -295,7 +291,11 @@ async function runLlmSetup(api, ctx, mode) {
         if (!provider) {
             continue;
         }
-        const saved = await runApiKeySetup(ctx, provider);
+        if (!modelRuntime) {
+            ctx.ui.notify("Model authentication is unavailable in this session.", "error");
+            return "cancelled";
+        }
+        const saved = await runApiKeySetup(ctx, provider, modelRuntime);
         if (!saved) {
             continue;
         }
@@ -309,11 +309,10 @@ async function runLlmSetup(api, ctx, mode) {
         }
     }
 }
-export async function runOpenCandleSetup(api, ctx, options = { mode: "startup" }) {
+export async function runOpenCandleSetup(api, ctx, options = { mode: "startup" }, modelRuntime) {
     const initialRequirement = getLlmSetupRequirement(ctx);
     if (initialRequirement !== "ready" || options.mode === "manual") {
-        return runLlmSetup(api, ctx, options.mode);
+        return runLlmSetup(api, ctx, options.mode, modelRuntime);
     }
     return "ready";
 }
-//# sourceMappingURL=setup.js.map

package/dist/pi/tool-adapter.js

@@ -31,4 +31,3 @@ function safeGetDefaults(toolName) {
         return {};
     }
 }
-//# sourceMappingURL=tool-adapter.js.map

package/dist/pi/tui-session-coordinator.js

@@ -280,4 +280,3 @@ function asRecord(value) {
         ? value
         : {};
 }
-//# sourceMappingURL=tui-session-coordinator.js.map

package/dist/prompts/context-builder.js

@@ -33,7 +33,7 @@ export class PromptContextBuilder {
         let truncationMarkers = 0;
         for (const name of SECTION_ORDER) {
             const section = this.sections.get(name);
-            if (!section.content)
+            if (!section?.content)
                 continue;
             const truncated = truncateTobudget(section.content, section.characterBudget);
             const wasTruncated = truncated.includes("[...truncated]");
@@ -258,4 +258,3 @@ Every committal response MUST carry four elements:
 
 ## Assumption Disclosure
 Structured workflow prompts may include a pre-rendered "Assumptions" block with correct source attribution (user-specified, saved preference, or default). Start with that block only when the workflow instructions explicitly say to. Fallback prompts include "Assumptions Context" only for internal routing context; do not reproduce that context unless the user explicitly asks for assumptions. Do NOT independently relabel any value's source anywhere in your response. When an assumptions block is shown, it is the single authoritative provenance representation.`;
-//# sourceMappingURL=context-builder.js.map

package/dist/prompts/disclaimer.js

@@ -6,4 +6,3 @@
 export const DISCLAIMER_TEXT = "OpenCandle is a research and analysis tool, not financial advice or a fiduciary financial advisor. " +
     "Views, targets, and allocations are informational analyst output — not personalized recommendations. " +
     "Verify independently before acting.";
-//# sourceMappingURL=disclaimer.js.map

package/dist/prompts/policy-cards.js

@@ -198,4 +198,3 @@ function placeholder(id, taskFamily, capabilityGapIds) {
         content: "",
     };
 }
-//# sourceMappingURL=policy-cards.js.map

package/dist/prompts/sections.js

@@ -32,4 +32,3 @@ export const DEFAULT_BUDGETS = {
     "provider-status": 500,
     "output-format": 2500,
 };
-//# sourceMappingURL=sections.js.map

package/dist/prompts/symbol-preflight.js

@@ -46,4 +46,3 @@ function validateSymbol(symbol, search) {
         checkedAt: Date.now(),
     }));
 }
-//# sourceMappingURL=symbol-preflight.js.map

package/dist/prompts/workflow-prompts.js

@@ -322,11 +322,12 @@ export function buildCompareAssetsPrompt(resolution) {
     const isOverlapComparison = resolution.resolved.metrics?.includes("overlap") ?? false;
     const hasFundContext = isFundOrIndexAssetScope(resolution.resolved.assetScope) || areLikelyFundOrIndexSymbols(symbols);
     const shouldProbeFundOverlap = !isOverlapComparison && isLongInvestmentHorizon(timeHorizon) && hasFundContext;
+    const technicalEndStep = shouldProbeFundOverlap ? 7 : 6;
     const sentimentStep = includeSentiment
-        ? `\n6. Use get_sentiment_summary for each of: ${symbolList} to compare retail/news sentiment and note source availability.`
+        ? `\n${technicalEndStep + 1}. Use get_sentiment_summary for each of: ${symbolList} to compare retail/news sentiment and note source availability.`
         : "";
     const interestRateStep = isInterestRateSensitive
-        ? `\n${includeSentiment ? "7" : "6"}. Use get_economic_data for the current Fed funds backdrop. Treat this as historical/current context unless you also have explicit futures or forecast evidence.`
+        ? `\n${technicalEndStep + (includeSentiment ? 2 : 1)}. Use get_economic_data for the current Fed funds backdrop. Treat this as historical/current context unless you also have explicit futures or forecast evidence.`
         : "";
     const sentimentMetric = includeSentiment ? ", sentiment score/summary" : "";
     const interestRateGuidance = isInterestRateSensitive
@@ -376,23 +377,23 @@ macro hedge decision guidance:
                 : `- Present a comparison table with key metrics: price, P/E, revenue growth, profit margin, RSI, Sharpe, max drawdown${sentimentMetric}.
 - Highlight which asset is stronger on each metric.`;
     const technicalRiskSteps = isOverlapComparison
-        ? `3. Use analyze_holdings_overlap with symbols [${symbolList}] to fetch provider top holdings and compute pairwise overlap by weight.
-4. Use analyze_correlation across [${symbolList}] only as supporting diversification evidence; do not substitute correlation for holdings overlap.
-5. Skip momentum/risk tool calls unless the user asks about timing or trade setup; the core question is top holdings and sector overlap.`
+        ? `4. Use analyze_holdings_overlap with symbols [${symbolList}] to fetch provider top holdings and compute pairwise overlap by weight.
+5. Use analyze_correlation across [${symbolList}] only as supporting diversification evidence; do not substitute correlation for holdings overlap.
+6. Skip momentum/risk tool calls unless the user asks about timing or trade setup; the core question is top holdings and sector overlap.`
         : shouldProbeFundOverlap
-            ? `3. Use analyze_holdings_overlap with symbols [${symbolList}] to fetch provider top holdings and compute pairwise overlap by weight.
-4. Use analyze_correlation across [${symbolList}] as supporting diversification evidence.
-5. Use analyze_risk for each to compare long-horizon risk context.
-6. Use get_technical_indicators only as secondary timing context; do not let RSI or short-term momentum dominate the long-horizon fund decision.`
-            : `3. Use get_technical_indicators for each to compare momentum and trend.
-4. Use analyze_risk for each to compare risk metrics.
-5. Use analyze_correlation across [${symbolList}] to check diversification.`;
+            ? `4. Use analyze_holdings_overlap with symbols [${symbolList}] to fetch provider top holdings and compute pairwise overlap by weight.
+5. Use analyze_correlation across [${symbolList}] as supporting diversification evidence.
+6. Use analyze_risk for each to compare long-horizon risk context.
+7. Use get_technical_indicators only as secondary timing context; do not let RSI or short-term momentum dominate the long-horizon fund decision.`
+            : `4. Use get_technical_indicators for each to compare momentum and trend.
+5. Use analyze_risk for each to compare risk metrics.
+6. Use analyze_correlation across [${symbolList}] to check diversification.`;
     const horizonLine = timeHorizon ? `\nTime horizon: ${timeHorizon}` : "";
     const budgetLine = budget !== undefined ? `\nBudget: ${formatBudget(budget)}` : "";
     const horizonSteps = timeHorizon
         ? `
-6. Adapt the comparison to the ${timeHorizon} horizon: prioritize near-term catalysts, earnings/guidance, estimate revisions, sentiment, and forward-looking valuation evidence over long-term historical averages.
-7. Use historical risk and technical metrics as context, but explain what they do and do not imply over ${timeHorizon}.`
+${technicalEndStep + (includeSentiment ? 1 : 0) + (isInterestRateSensitive ? 1 : 0) + 1}. Adapt the comparison to the ${timeHorizon} horizon: prioritize near-term catalysts, earnings/guidance, estimate revisions, sentiment, and forward-looking valuation evidence over long-term historical averages.
+${technicalEndStep + (includeSentiment ? 1 : 0) + (isInterestRateSensitive ? 1 : 0) + 2}. Use historical risk and technical metrics as context, but explain what they do and do not imply over ${timeHorizon}.`
         : "";
     const horizonResponse = timeHorizon
         ? `
@@ -427,6 +428,7 @@ Compare these assets side by side: ${symbolList}${horizonLine}${budgetLine}
 Steps:
 1. Use get_stock_quote for each of: ${symbolList}.
 2. Use compare_companies with symbols [${symbols.map((s) => `"${s}"`).join(", ")}] for peer metrics. If some fundamentals are unavailable, continue the comparison with the available symbols and mark missing metrics as unavailable.
+3. Use get_price_comparison with symbols [${symbolList}] and a range that fits the resolved time horizon; use the default comparison range when no time horizon is resolved so the answer includes an indexed price comparison.
 ${technicalRiskSteps}${sentimentStep}${interestRateStep}${horizonSteps}
 ${macroHedgeSteps}
 ${interestRateGuidance}
@@ -442,4 +444,3 @@ ${tableInstruction}
 ${actionPlanResponse}
 - Note any caveats (different sectors, concentration, market cap disparity, unavailable fundamentals, unavailable forward-looking estimates, etc.).${horizonResponse}`;
 }
-//# sourceMappingURL=workflow-prompts.js.map

package/dist/providers/alpha-vantage.js

@@ -182,7 +182,7 @@ export async function getGlobalQuote(symbol, apiKey) {
         const data = await httpGet(url);
         throwIfApiMessage(data);
         const gq = data["Global Quote"];
-        if (!gq || !gq["05. price"]) {
+        if (!gq?.["05. price"]) {
             throw new Error(`Alpha Vantage: No quote data for ${symbol}`);
         }
         const price = parseFloat(gq["05. price"]) || 0;
@@ -291,6 +291,5 @@ function parseNullableNum(s) {
     if (!s || s === "None" || s === "-")
         return null;
     const n = parseFloat(s);
-    return isNaN(n) ? null : n;
+    return Number.isNaN(n) ? null : n;
 }
-//# sourceMappingURL=alpha-vantage.js.map

package/dist/providers/coingecko.js

@@ -67,4 +67,3 @@ export async function getCryptoHistory(id, days = 180) {
         throw error;
     }
 }
-//# sourceMappingURL=coingecko.js.map

package/dist/providers/errors.js

@@ -8,4 +8,3 @@ export class InvalidSymbolError extends Error {
         this.name = "InvalidSymbolError";
     }
 }
-//# sourceMappingURL=errors.js.map

package/dist/providers/exa-search.js

@@ -90,14 +90,16 @@ function parseMcpResultBlocks(text) {
     return results;
 }
 function mapApiResults(results) {
-    return results
-        .filter((r) => r.url)
-        .map((r) => ({
-        title: r.title ?? "",
-        url: r.url,
-        published: r.publishedDate ?? null,
-        snippet: (r.highlights?.join(" ") || r.text || "").slice(0, SNIPPET_MAX_CHARS),
-    }));
+    return results.flatMap((r) => {
+        if (!r.url)
+            return [];
+        return {
+            title: r.title ?? "",
+            url: r.url,
+            published: r.publishedDate ?? null,
+            snippet: (r.highlights?.join(" ") || r.text || "").slice(0, SNIPPET_MAX_CHARS),
+        };
+    });
 }
 // ---------------------------------------------------------------------------
 // Freshness post-filter
@@ -108,7 +110,7 @@ function filterByFreshness(results, freshness) {
         if (!r.published)
             return true; // benefit of the doubt
         const pubTime = new Date(r.published).getTime();
-        return !isNaN(pubTime) && pubTime >= cutoff;
+        return !Number.isNaN(pubTime) && pubTime >= cutoff;
     });
 }
 // ---------------------------------------------------------------------------
@@ -281,4 +283,3 @@ export async function exaSearch(query, opts) {
 }
 // Exported for testing
 export { enrichQueryForMcp, extractJsonRpcPayload, filterByFreshness, mapApiResults, parseMcpResultBlocks, };
-//# sourceMappingURL=exa-search.js.map

package/dist/providers/external-tool-command.js

@@ -111,4 +111,3 @@ function commandNames(command, platform) {
     }
     return names;
 }
-//# sourceMappingURL=external-tool-command.js.map

package/dist/providers/external-tool-error.js

@@ -18,4 +18,3 @@ export class ExternalToolNotInstalled extends Error {
         this.name = "ExternalToolNotInstalled";
     }
 }
-//# sourceMappingURL=external-tool-error.js.map

package/dist/providers/fear-greed.js

@@ -31,4 +31,3 @@ export async function getFearGreedIndex() {
         throw error;
     }
 }
-//# sourceMappingURL=fear-greed.js.map

package/dist/providers/finnhub.js

@@ -89,4 +89,3 @@ export async function getCompanyNews(symbol, from, to, apiKey) {
         throw error;
     }
 }
-//# sourceMappingURL=finnhub.js.map

package/dist/providers/fred.js

@@ -54,4 +54,3 @@ export async function getSeries(seriesId, apiKey, limit = 60) {
         throw error;
     }
 }
-//# sourceMappingURL=fred.js.map

package/dist/providers/index.d.ts

@@ -2,6 +2,7 @@ export { getEarnings, getFinancials, getOverview } from "./alpha-vantage.js";
 export { getCryptoHistory, getCryptoPrice } from "./coingecko.js";
 export { getFearGreedIndex } from "./fear-greed.js";
 export { getSeries } from "./fred.js";
+export { getLseCandles, getLseFinancialReports, getLseFinancials, type LseCandle, type LseFinancialReportRow, LseHttpError, type LseTimeframe, toLseTimeframe, } from "./lse.js";
 export { getSubredditPosts, scoreSentiment } from "./reddit.js";
 export { type SECFiling, searchFilings } from "./sec-edgar.js";
 export { getQuotes, screenStocks } from "./tradingview.js";

package/dist/providers/index.js

@@ -2,9 +2,9 @@ export { getEarnings, getFinancials, getOverview } from "./alpha-vantage.js";
 export { getCryptoHistory, getCryptoPrice } from "./coingecko.js";
 export { getFearGreedIndex } from "./fear-greed.js";
 export { getSeries } from "./fred.js";
+export { getLseCandles, getLseFinancialReports, getLseFinancials, LseHttpError, toLseTimeframe, } from "./lse.js";
 export { getSubredditPosts, scoreSentiment } from "./reddit.js";
 export { searchFilings } from "./sec-edgar.js";
 export { getQuotes, screenStocks } from "./tradingview.js";
 export { braveSearch, ddgSearch, normalizeFinancialQuery, searchWeb } from "./web-search.js";
 export { clearCrumbCache, computeTimeToExpiry, getHistory, getOptionsChain, getQuote, getYahooCrumb, } from "./yahoo-finance.js";
-//# sourceMappingURL=index.js.map

package/dist/providers/lse.d.ts

@@ -0,0 +1,35 @@
+import type { FinancialStatement } from "../types/fundamentals.js";
+export type LseTimeframe = "1m" | "5m" | "15m" | "1h" | "1d" | "1w" | "1mo";
+export interface LseCandle {
+    ts: string;
+    symbol: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+export type LseFinancialReportRow = Record<string, unknown>;
+interface LseCandleOptions {
+    start?: string;
+    end?: string;
+    order?: "asc" | "desc";
+    limit?: number;
+}
+interface LseFinancialReportOptions {
+    period?: "FY" | "Q1" | "Q2" | "Q3" | "Q4";
+    start?: string;
+    end?: string;
+    order?: "asc" | "desc";
+    limit?: number;
+}
+export declare class LseHttpError extends Error {
+    readonly status: number;
+    readonly detail: string;
+    constructor(status: number, detail: string);
+}
+export declare function getLseCandles(symbol: string, timeframe: LseTimeframe, opts?: LseCandleOptions): Promise<LseCandle[]>;
+export declare function getLseFinancialReports(symbol: string, reportType: "income" | "balance" | "cashflow", opts?: LseFinancialReportOptions): Promise<LseFinancialReportRow[]>;
+export declare function getLseFinancials(symbol: string): Promise<FinancialStatement[]>;
+export declare function toLseTimeframe(interval: string): LseTimeframe | undefined;
+export {};