opencandle 0.12.0 → 0.13.0

package/dist/gui/server/market-state-api.js

@@ -2,8 +2,135 @@ import { buildFreshnessStamp } from "../../infra/freshness.js";
 import { isZeroFilledQuote, searchYahooInstruments } from "../../market-state/resolve.js";
 import { MarketStateService } from "../../market-state/service.js";
 import { initDefaultDatabase } from "../../memory/sqlite.js";
+import { getProvider } from "../../onboarding/providers.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
-import { getQuote } from "../../providers/yahoo-finance.js";
+import { getHistory, getQuote, getYahooCompanyOverview, } from "../../providers/yahoo-finance.js";
+import { fetchHistoryWithFallback, HISTORY_INTERVALS, } from "../../tools/market/stock-history.js";
+import { HistorySnapshotStore } from "./history-snapshot-store.js";
+const instrumentHistorySnapshotStore = new HistorySnapshotStore();
+const DEFAULT_HISTORY_RANGE_MAP = {
+    "1D": { range: "1d", interval: "5m" },
+    "5D": { range: "5d", interval: "15m" },
+    "1M": { range: "1mo", interval: "1h" },
+    "6M": { range: "6mo", interval: "1d" },
+    YTD: { range: "ytd", interval: "1d" },
+    "1Y": { range: "1y", interval: "1d" },
+    "5Y": { range: "5y", interval: "1wk" },
+    MAX: { range: "max", interval: "1mo" },
+};
+const HISTORY_RANGE_SPAN_DAYS = {
+    "1D": 1,
+    "5D": 5,
+    "1M": 31,
+    "6M": 183,
+    YTD: 366,
+    "1Y": 366,
+    "5Y": 1_827,
+    MAX: Number.POSITIVE_INFINITY,
+};
+const INTRADAY_DEPTH_CAP_DAYS = {
+    "1m": 7,
+    "5m": 60,
+    "15m": 60,
+    "1h": 730,
+};
+const DAILY_OR_LONGER_INTERVALS = new Set(["1d", "1wk", "1mo"]);
+const HISTORY_PROVIDER_REGISTRY_IDS = {
+    yahoo: "yahoo",
+    alphavantage: "alpha_vantage",
+    lse: "lse",
+};
+function historyProviderDisplayName(provider) {
+    if (!(provider && provider in HISTORY_PROVIDER_REGISTRY_IDS))
+        return null;
+    const providerId = HISTORY_PROVIDER_REGISTRY_IDS[provider];
+    return getProvider(providerId).displayName;
+}
+export function resolveHistoryRange(rangeLabel, intervalOverride) {
+    const resolved = DEFAULT_HISTORY_RANGE_MAP[rangeLabel];
+    if (!resolved) {
+        return { status: "invalid_request", reason: `Unknown history range: ${rangeLabel}` };
+    }
+    if (intervalOverride === undefined)
+        return resolved;
+    if (!isHistoryInterval(intervalOverride)) {
+        return { status: "invalid_request", reason: `Unknown history interval: ${intervalOverride}` };
+    }
+    const depthCapDays = INTRADAY_DEPTH_CAP_DAYS[intervalOverride];
+    if (depthCapDays !== undefined &&
+        HISTORY_RANGE_SPAN_DAYS[rangeLabel] > depthCapDays) {
+        return {
+            status: "invalid_request",
+            reason: `History range ${rangeLabel} exceeds the depth cap for interval ${intervalOverride}`,
+        };
+    }
+    return { range: resolved.range, interval: intervalOverride };
+}
+function isHistoryInterval(value) {
+    return HISTORY_INTERVALS.includes(value);
+}
+export async function getInstrumentHistorySnapshot(symbol, rangeLabel = "1D", intervalOverride) {
+    const resolved = resolveHistoryRange(rangeLabel, intervalOverride);
+    if ("status" in resolved)
+        return resolved;
+    const key = `${symbol}|${resolved.range}|${resolved.interval}`;
+    return instrumentHistorySnapshotStore.get(key, async () => {
+        const result = await fetchHistoryWithFallback(symbol, resolved.range, resolved.interval);
+        if (result.status === "unavailable") {
+            return { status: "unavailable", reason: result.reason };
+        }
+        const source = historyProviderDisplayName(result.provider);
+        if (source === null) {
+            return { status: "unavailable", reason: "History provider attribution is unavailable" };
+        }
+        const bars = result.data.filter((bar) => Number.isFinite(bar.close));
+        const dataAsOf = bars.at(-1)?.date;
+        const chartBars = [];
+        for (const bar of bars) {
+            let time = bar.timestamp;
+            if (typeof time !== "number" || !Number.isFinite(time)) {
+                if (DAILY_OR_LONGER_INTERVALS.has(resolved.interval)) {
+                    time = Date.parse(`${bar.date}T00:00:00Z`) / 1_000;
+                }
+                if (typeof time !== "number" || !Number.isFinite(time)) {
+                    return {
+                        status: "unavailable",
+                        reason: `Historical bars for ${resolved.interval} are missing finite timestamps`,
+                        dataAsOf,
+                        stale: result.stale === true || undefined,
+                    };
+                }
+            }
+            chartBars.push({
+                time,
+                open: bar.open,
+                high: bar.high,
+                low: bar.low,
+                close: bar.close,
+                volume: bar.volume,
+            });
+        }
+        // Design D3: daily+ bars can honestly derive the previous close from the prior bar.
+        const prevClose = DAILY_OR_LONGER_INTERVALS.has(resolved.interval) && bars.length >= 2
+            ? bars[bars.length - 2].close
+            : null;
+        return {
+            status: "ok",
+            symbol,
+            range: rangeLabel,
+            interval: resolved.interval,
+            source,
+            fetchedAt: result.timestamp,
+            dataAsOf,
+            stale: result.stale === true,
+            prevClose,
+            bars: chartBars,
+        };
+    });
+}
+export function resetInstrumentHistoryMemoForTests() {
+    instrumentHistorySnapshotStore.clear();
+}
 export function createSavedSymbolsMemo(load, options = {}) {
     const ttlMs = options.ttlMs ?? 30_000;
     const now = options.now ?? Date.now;
@@ -96,8 +223,13 @@ export async function buildMarketStateQuoteSnapshot(db) {
             ]),
         ];
         const quoteMap = new Map();
+        const sparklineMap = new Map();
         for (const symbol of symbols) {
-            quoteMap.set(symbol, await fetchQuoteSnapshot(symbol));
+            const quote = await fetchQuoteSnapshot(symbol);
+            quoteMap.set(symbol, quote);
+            sparklineMap.set(symbol, quote.status === "ok"
+                ? await fetchSparklineSnapshot(symbol)
+                : unavailableSparkline(quote.reason));
         }
         const generatedAt = new Date().toISOString();
         const watchlistQuotes = watchlist.map((item) => {
@@ -109,6 +241,7 @@ export async function buildMarketStateQuoteSnapshot(db) {
                     symbol: item.symbol,
                     status: "unavailable",
                     reason: quote?.reason ?? "quote unavailable",
+                    sparkline: sparklineMap.get(item.symbol) ?? unavailableSparkline("History unavailable"),
                 };
             }
             return {
@@ -134,12 +267,14 @@ export async function buildMarketStateQuoteSnapshot(db) {
                 extendedChangePercent: quote.extendedChangePercent,
                 extendedAsOf: quote.extendedAsOf,
                 stale: quote.stale,
+                sparkline: sparklineMap.get(item.symbol) ?? unavailableSparkline("History unavailable"),
             };
         });
         const portfolioResults = portfolios.map((portfolio) => buildPortfolioQuoteResult({
             portfolio,
             lots: portfolioLots.filter((lot) => lot.portfolioId === portfolio.id),
             quoteMap,
+            sparklineMap,
         }));
         const defaultPortfolio = portfolios.find((portfolio) => portfolio.isDefault) ?? portfolios[0];
         const defaultResult = portfolioResults.find((result) => result.summary.portfolioId === defaultPortfolio.id) ??
@@ -157,7 +292,7 @@ export async function buildMarketStateQuoteSnapshot(db) {
             ownedDb.close();
     }
 }
-function buildPortfolioQuoteResult({ portfolio, lots, quoteMap, }) {
+function buildPortfolioQuoteResult({ portfolio, lots, quoteMap, sparklineMap, }) {
     const baseCurrency = portfolio.baseCurrency ?? "USD";
     const portfolioQuotes = lots.map((lot) => {
         const quote = quoteMap.get(lot.symbol);
@@ -177,6 +312,7 @@ function buildPortfolioQuoteResult({ portfolio, lots, quoteMap, }) {
                 currency: lotCurrency,
                 includedInTotals: false,
                 reason: quote?.reason ?? "quote unavailable",
+                sparkline: sparklineMap.get(lot.symbol) ?? unavailableSparkline("History unavailable"),
             };
         }
         const resolvedQuoteCurrency = quote.currency ?? quoteCurrency;
@@ -203,6 +339,7 @@ function buildPortfolioQuoteResult({ portfolio, lots, quoteMap, }) {
                 extendedChangePercent: quote.extendedChangePercent,
                 extendedAsOf: quote.extendedAsOf,
                 stale: quote.stale,
+                sparkline: sparklineMap.get(lot.symbol) ?? unavailableSparkline("History unavailable"),
             };
         }
         const marketValue = quote.price * lot.quantity;
@@ -229,6 +366,7 @@ function buildPortfolioQuoteResult({ portfolio, lots, quoteMap, }) {
             extendedChangePercent: quote.extendedChangePercent,
             extendedAsOf: quote.extendedAsOf,
             stale: quote.stale,
+            sparkline: sparklineMap.get(lot.symbol) ?? unavailableSparkline("History unavailable"),
             reason: includedInTotals
                 ? undefined
                 : `No FX conversion from ${lotCurrency === baseCurrency ? quoteCurrency : lotCurrency} to ${baseCurrency}`,
@@ -265,6 +403,36 @@ function buildPortfolioQuoteResult({ portfolio, lots, quoteMap, }) {
         },
     };
 }
+export async function fetchSparklineSnapshot(symbol) {
+    const result = await wrapProvider("yahoo", () => getHistory(symbol, "1d", "5m"));
+    if (result.status === "unavailable")
+        return unavailableSparkline(result.reason);
+    const bars = result.data.filter((bar) => Number.isFinite(bar.close));
+    const dataAsOf = bars.at(-1)?.date;
+    if (result.stale) {
+        return unavailableSparkline("Historical data is stale", dataAsOf, true);
+    }
+    if (bars.length < 2) {
+        return unavailableSparkline("Not enough intraday history", dataAsOf);
+    }
+    return {
+        status: "ok",
+        source: "Yahoo Finance",
+        points: bars.map((bar) => bar.close),
+        fetchedAt: result.timestamp,
+        dataAsOf,
+        stale: false,
+    };
+}
+function unavailableSparkline(reason, dataAsOf, stale) {
+    return {
+        status: "unavailable",
+        source: "Yahoo Finance",
+        reason,
+        dataAsOf,
+        stale,
+    };
+}
 export async function searchInstrumentCandidates(query) {
     const trimmed = query.trim();
     if (!trimmed)
@@ -302,6 +470,7 @@ export async function getInstrumentQuoteSnapshot(symbol) {
         low: quote.low,
         week52High: quote.week52High,
         week52Low: quote.week52Low,
+        marketCap: quote.marketCap,
         fetchedAt: quote.fetchedAt,
         dataAsOf: quote.dataAsOf,
         marketState: quote.marketState,
@@ -313,7 +482,79 @@ export async function getInstrumentQuoteSnapshot(symbol) {
         currency: quote.currency,
     };
 }
-async function fetchQuoteSnapshot(symbol) {
+const INSTRUMENT_OVERVIEW_TTL_MS = 5 * 60_000;
+const instrumentOverviewMemo = new Map();
+export async function getInstrumentOverviewSnapshot(symbol) {
+    const normalized = symbol.trim().toUpperCase();
+    if (!normalized)
+        return { symbol: "", status: "unavailable", reason: "symbol is required" };
+    const existing = instrumentOverviewMemo.get(normalized);
+    if (existing?.snapshot && Date.now() - existing.fetchedAtMs < INSTRUMENT_OVERVIEW_TTL_MS) {
+        return existing.snapshot;
+    }
+    if (existing?.snapshot) {
+        if (!existing.inFlight)
+            refreshInstrumentOverview(normalized, existing).catch(() => { });
+        return existing.snapshot.status === "ok"
+            ? { ...existing.snapshot, stale: true }
+            : existing.snapshot;
+    }
+    if (existing?.inFlight)
+        return existing.inFlight;
+    const entry = existing ?? { snapshot: null, fetchedAtMs: 0, inFlight: null };
+    return refreshInstrumentOverview(normalized, entry);
+}
+function refreshInstrumentOverview(normalized, entry) {
+    if (entry.inFlight)
+        return entry.inFlight;
+    const inFlight = loadInstrumentOverviewSnapshot(normalized)
+        .then((snapshot) => {
+        if (entry.snapshot?.status === "ok" && snapshot.status === "unavailable") {
+            return entry.snapshot;
+        }
+        entry.snapshot = snapshot;
+        entry.fetchedAtMs = Date.now();
+        return snapshot;
+    })
+        .finally(() => {
+        if (entry.inFlight === inFlight)
+            entry.inFlight = null;
+    });
+    entry.inFlight = inFlight;
+    instrumentOverviewMemo.set(normalized, entry);
+    return inFlight;
+}
+async function loadInstrumentOverviewSnapshot(normalized) {
+    const result = await wrapProvider("yahoo", () => getYahooCompanyOverview(normalized));
+    if (result.status === "unavailable") {
+        return { symbol: normalized, status: "unavailable", reason: result.reason };
+    }
+    return {
+        symbol: normalized,
+        status: "ok",
+        name: result.data.name,
+        description: result.data.description,
+        exchange: result.data.exchange,
+        sector: result.data.sector,
+        industry: result.data.industry,
+        marketCap: result.data.marketCap,
+        pe: result.data.pe,
+        forwardPe: result.data.forwardPe,
+        eps: result.data.eps,
+        dividendYield: result.data.dividendYield,
+        beta: result.data.beta,
+        avgVolume: result.data.avgVolume,
+        profitMargin: result.data.profitMargin,
+        revenueGrowth: result.data.revenueGrowth,
+        week52High: result.data.week52High,
+        week52Low: result.data.week52Low,
+        stale: result.stale === true,
+    };
+}
+export function resetInstrumentOverviewMemoForTests() {
+    instrumentOverviewMemo.clear();
+}
+export async function fetchQuoteSnapshot(symbol) {
     const result = await wrapProvider("yahoo", () => getQuote(symbol));
     if (result.status === "unavailable")
         return { status: "unavailable", reason: result.reason };
@@ -342,6 +583,7 @@ async function fetchQuoteSnapshot(symbol) {
         low: result.data.low,
         week52High: result.data.week52High,
         week52Low: result.data.week52Low,
+        marketCap: result.data.marketCap,
         fetchedAt: result.timestamp,
         dataAsOf: freshness.providerDataAt,
         marketState: result.data.marketState,

package/dist/gui/server/model-setup.d.ts

@@ -1,4 +1,5 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
+import { type ModelRuntime } from "@earendil-works/pi-coding-agent";
 export type ModelSetupRequirement = "ready" | "select_model" | "connect_auth";
 export interface ModelSetupProvider {
     id: string;
@@ -23,18 +24,8 @@ export interface ModelSetupRegistry {
     getAvailable(): Model<Api>[];
     hasConfiguredAuth(model: Model<Api>): boolean;
 }
-interface ModelSetupAuthStorage {
-    set(provider: string, credential: {
-        type: "api_key";
-        key: string;
-    }): void;
-}
-interface MutableModelSetupRegistry extends ModelSetupRegistry {
-    authStorage: ModelSetupAuthStorage;
-    find(provider: string, modelId: string): Model<Api> | undefined;
-}
 interface ModelSetupSession {
-    modelRegistry: MutableModelSetupRegistry;
+    modelRuntime: ModelRuntime;
     model?: Model<Api>;
     setModel(model: Model<Api>): Promise<void>;
     settingsManager: {

package/dist/gui/server/model-setup.js

@@ -1,3 +1,4 @@
+import { ModelRegistry } from "@earendil-works/pi-coding-agent";
 import { persistProviderCredential } from "../../onboarding/connect.js";
 import { getCredentialSource, isApiKeyProvider, PROVIDERS, } from "../../onboarding/providers.js";
 import { validateModelKey, } from "../../onboarding/validate-model-key.js";
@@ -72,7 +73,7 @@ export function createModelSetupController({ role, getSession, getSessionManager
     }
     function buildCurrentModelSetupState() {
         const session = getSession();
-        return buildModelSetupState(session.modelRegistry, session.model);
+        return buildModelSetupState(new ModelRegistry(session.modelRuntime), session.model);
     }
     async function handleSaveModelApiKey(providerId, apiKey) {
         ensureWriter();
@@ -87,9 +88,12 @@ export function createModelSetupController({ role, getSession, getSessionManager
             throw new Error(`Key was rejected by ${validation.providerLabel}. The existing configuration was not changed.`);
         }
         const session = getSession();
-        session.modelRegistry.authStorage.set(provider.id, { type: "api_key", key: trimmed });
-        session.modelRegistry.refresh();
-        const model = findPreferredModel(session.modelRegistry, provider);
+        await session.modelRuntime.login(provider.id, "api_key", {
+            prompt: async () => trimmed,
+            notify: () => { },
+        });
+        const modelRegistry = new ModelRegistry(session.modelRuntime);
+        const model = findPreferredModel(modelRegistry, provider);
         if (!model) {
             throw new Error(`Saved the ${provider.label} key, but no ${provider.label} models are available yet.`);
         }
@@ -134,8 +138,8 @@ export function createModelSetupController({ role, getSession, getSessionManager
     async function handleSelectModel(provider, modelId) {
         ensureWriter();
         const session = getSession();
-        session.modelRegistry.refresh();
-        const model = session.modelRegistry.find(provider, modelId);
+        await session.modelRuntime.refresh();
+        const model = session.modelRuntime.getModel(provider, modelId);
         if (!model)
             throw new Error(`Unknown model: ${provider}/${modelId}`);
         await session.setModel(model);

package/dist/gui/server/server.js

@@ -3,7 +3,7 @@ import { existsSync } from "node:fs";
 import { createServer } from "node:http";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { AuthStorage, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, ModelRegistry, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { createAgentSessionRuntime, createAgentSessionServices, getAgentDir, ModelRuntime, SettingsManager, } from "@earendil-works/pi-coding-agent";
 import { createOpenCandleSession } from "../../index.js";
 import { assertSupportedNodeVersion } from "../../infra/node-version.js";
 import { createAskUserBridge } from "./ask-user-bridge.js";
@@ -13,6 +13,8 @@ import { createInitialGuiSessionManager } from "./gui-session-manager.js";
 import { createHttpRequestHandler, resolveSessionManagerById } from "./http-routes.js";
 import { createToolInvokeController } from "./invoke-tool.js";
 import { createLocalSessionCoordinator } from "./local-session-coordinator.js";
+import { buildMarketIndicesSnapshot } from "./market-indices-api.js";
+import { MarketIndicesSnapshotStore } from "./market-indices-snapshot-store.js";
 import { buildMarketStateQuoteSnapshot } from "./market-state-api.js";
 import { createModelSetupController } from "./model-setup.js";
 import { isTrustedPrivateApiRequest } from "./private-api-access.js";
@@ -33,8 +35,10 @@ const localCoordinatorEndpoint = `http://${coordinatorEndpointHost(host)}:${port
 const __dirname = fileURLToPath(new URL(".", import.meta.url));
 const webDist = resolveGuiWebDist(__dirname);
 const agentDir = getAgentDir();
-const authStorage = AuthStorage.create();
-const modelRegistry = ModelRegistry.create(authStorage);
+const modelRuntime = await ModelRuntime.create({
+    authPath: resolve(agentDir, "auth.json"),
+    modelsPath: resolve(agentDir, "models.json"),
+});
 const settingsManager = SettingsManager.create(cwd, agentDir);
 const initialSessionManager = createInitialGuiSessionManager(cwd);
 let sessionManager = initialSessionManager;
@@ -56,15 +60,13 @@ const runtime = await createAgentSessionRuntime(async (opts) => {
     const services = await createAgentSessionServices({
         cwd: opts.cwd,
         agentDir: opts.agentDir,
-        authStorage,
         settingsManager,
-        modelRegistry,
+        modelRuntime,
     });
     const result = await createOpenCandleSession({
         cwd: opts.cwd,
         agentDir: opts.agentDir,
-        authStorage,
-        modelRegistry,
+        modelRuntime,
         settingsManager,
         sessionManager: opts.sessionManager,
         askUserHandler: askUserBridge.ask,
@@ -100,6 +102,7 @@ const heartbeat = setInterval(() => {
 const backgroundQuoteRefreshes = new BackgroundQuoteRefreshes();
 const localSessionCoordinator = createLocalSessionCoordinator();
 const quoteSnapshotStore = new QuoteSnapshotStore(() => buildMarketStateQuoteSnapshot());
+const indicesSnapshotStore = new MarketIndicesSnapshotStore(() => buildMarketIndicesSnapshot());
 quotePoller = createBackgroundQuotePoller({
     getClientCount: () => wsHub.getClientCount(),
     getSessionManager: () => sessionManager,
@@ -200,8 +203,7 @@ const httpRequestHandler = createHttpRequestHandler({
     createSessionForManager: async (targetSessionManager) => createOpenCandleSession({
         cwd,
         agentDir,
-        authStorage,
-        modelRegistry,
+        modelRuntime,
         settingsManager,
         sessionManager: targetSessionManager,
         askUserHandler: askUserBridge.askForSession(targetSessionManager.getSessionId()),
@@ -211,6 +213,7 @@ const httpRequestHandler = createHttpRequestHandler({
     sessionActionsController,
     toolInvokeController,
     quoteSnapshotStore,
+    indicesSnapshotStore,
     localSessionCoordinator,
 });
 const server = createServer((req, res) => {

package/dist/gui/server/tool-metadata.d.ts

@@ -20,13 +20,23 @@ export declare function buildCatalog(): {
         }[];
     }[];
     providers: ({
-        source: "env" | "file" | "absent";
+        id: import("../../onboarding/providers.js").ApiKeyProviderId | import("../../onboarding/providers.js").ExternalToolProviderId | import("../../onboarding/providers.js").PublicHttpProviderId;
+        kind: "api-key" | "external-tool" | "public-http";
+        displayName: string;
+        category: import("../../onboarding/providers.js").ProviderCategory;
+        tier: import("../../onboarding/providers.js").ProviderTier;
+        aliases: readonly string[];
+        unlocks: readonly string[];
+        fallbackDescription: string | null;
+        instructionsHint: string;
+        source: "absent" | "env" | "file";
         configured: boolean;
         maskedKeyHint: string | undefined;
-        status: "env" | "file" | "absent";
+        status: "absent" | "env" | "file";
         signupUrl: string;
         freeTier: boolean;
         envVar: string;
+    } | {
         id: import("../../onboarding/providers.js").ApiKeyProviderId | import("../../onboarding/providers.js").ExternalToolProviderId | import("../../onboarding/providers.js").PublicHttpProviderId;
         kind: "api-key" | "external-tool" | "public-http";
         displayName: string;
@@ -36,7 +46,6 @@ export declare function buildCatalog(): {
         unlocks: readonly string[];
         fallbackDescription: string | null;
         instructionsHint: string;
-    } | {
         status: string;
         statusDetail: {
             providerId: import("../../onboarding/providers.js").ExternalToolProviderId;
@@ -52,6 +61,7 @@ export declare function buildCatalog(): {
         installCmd: string;
         sessionSource: "browser-cookies";
         supportedBrowsers: readonly string[] | undefined;
+    } | {
         id: import("../../onboarding/providers.js").ApiKeyProviderId | import("../../onboarding/providers.js").ExternalToolProviderId | import("../../onboarding/providers.js").PublicHttpProviderId;
         kind: "api-key" | "external-tool" | "public-http";
         displayName: string;
@@ -61,12 +71,12 @@ export declare function buildCatalog(): {
         unlocks: readonly string[];
         fallbackDescription: string | null;
         instructionsHint: string;
-    } | {
         status: string;
         binary: string;
         installCmd: string;
         sessionSource: "browser-cookies";
         supportedBrowsers: readonly string[] | undefined;
+    } | {
         id: import("../../onboarding/providers.js").ApiKeyProviderId | import("../../onboarding/providers.js").ExternalToolProviderId | import("../../onboarding/providers.js").PublicHttpProviderId;
         kind: "api-key" | "external-tool" | "public-http";
         displayName: string;
@@ -76,18 +86,8 @@ export declare function buildCatalog(): {
         unlocks: readonly string[];
         fallbackDescription: string | null;
         instructionsHint: string;
-    } | {
         status: string;
         probeUrl: string;
-        id: import("../../onboarding/providers.js").ApiKeyProviderId | import("../../onboarding/providers.js").ExternalToolProviderId | import("../../onboarding/providers.js").PublicHttpProviderId;
-        kind: "api-key" | "external-tool" | "public-http";
-        displayName: string;
-        category: import("../../onboarding/providers.js").ProviderCategory;
-        tier: import("../../onboarding/providers.js").ProviderTier;
-        aliases: readonly string[];
-        unlocks: readonly string[];
-        fallbackDescription: string | null;
-        instructionsHint: string;
     })[];
 };
 export declare function setToolEnabled(toolName: string, enabled: boolean): void;

package/dist/gui/server/ws-hub.js

@@ -64,7 +64,7 @@ export function createWsHub({ role, lock, cwd, sessionDir, getSession, getSessio
                     client.send({ type: "catalog", catalog: buildCatalog() });
                     break;
                 case "model.setup.refresh":
-                    getSession().modelRegistry.refresh();
+                    await getSession().modelRuntime.refresh();
                     broadcastModelSetup();
                     break;
                 case "model.setup.save_api_key":

package/dist/infra/cache.d.ts

@@ -31,7 +31,9 @@ export declare const cache: Cache;
 export declare const TTL: {
     readonly QUOTE: 60000;
     readonly HISTORY: 3600000;
+    readonly CANDLES: 3600000;
     readonly FUNDAMENTALS: 86400000;
+    readonly FINANCIAL_REPORTS: 86400000;
     readonly MACRO: 3600000;
     readonly SENTIMENT: 300000;
     readonly OPTIONS_CHAIN: 120000;
@@ -44,7 +46,9 @@ export declare const TTL: {
 export declare const STALE_LIMIT: {
     readonly QUOTE: number;
     readonly HISTORY: number;
+    readonly CANDLES: number;
     readonly FUNDAMENTALS: number;
+    readonly FINANCIAL_REPORTS: number;
     readonly MACRO: number;
     readonly SENTIMENT: 3600000;
     readonly OPTIONS_CHAIN: number;

package/dist/infra/cache.js

@@ -69,7 +69,9 @@ export const cache = new Cache();
 export const TTL = {
     QUOTE: 60_000, // 1 minute
     HISTORY: 3_600_000, // 1 hour
+    CANDLES: 3_600_000, // 1 hour
     FUNDAMENTALS: 86_400_000, // 24 hours
+    FINANCIAL_REPORTS: 86_400_000, // 24 hours
     MACRO: 3_600_000, // 1 hour
     SENTIMENT: 300_000, // 5 minutes
     OPTIONS_CHAIN: 120_000, // 2 minutes
@@ -83,7 +85,9 @@ export const TTL = {
 export const STALE_LIMIT = {
     QUOTE: 15 * 60_000, // 15 minutes
     HISTORY: 24 * 3_600_000, // 24 hours
+    CANDLES: 24 * 3_600_000, // 24 hours
     FUNDAMENTALS: 7 * 86_400_000, // 7 days
+    FINANCIAL_REPORTS: 7 * 86_400_000, // 7 days
     MACRO: 24 * 3_600_000, // 24 hours
     SENTIMENT: 3_600_000, // 1 hour
     OPTIONS_CHAIN: 30 * 60_000, // 30 minutes

package/dist/infra/lse-byte-budget.d.ts

@@ -0,0 +1,10 @@
+export declare const LSE_MONTHLY_BYTE_CAP = 53687091200;
+export declare const LSE_SOFT_BYTE_THRESHOLD = 42949672960;
+export interface LseByteBudgetUsage {
+    month: string;
+    bytesUsed: number;
+}
+export declare function recordBytes(n: number): void;
+export declare function getUsage(): LseByteBudgetUsage;
+export declare function isOverSoftThreshold(): boolean;
+export declare function markExhausted(): void;

package/dist/infra/lse-byte-budget.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { ensureParentDir, resolveOpenCandlePath } from "./opencandle-paths.js";
+export const LSE_MONTHLY_BYTE_CAP = 53_687_091_200;
+export const LSE_SOFT_BYTE_THRESHOLD = 42_949_672_960;
+function currentMonth() {
+    return new Date().toISOString().slice(0, 7);
+}
+function budgetPath() {
+    return resolveOpenCandlePath("lse-byte-budget.json");
+}
+function readUsage() {
+    const month = currentMonth();
+    const path = budgetPath();
+    if (!existsSync(path))
+        return { month, bytesUsed: 0 };
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        const bytesUsed = parsed.bytesUsed;
+        if (parsed.month !== month || typeof bytesUsed !== "number" || !Number.isFinite(bytesUsed)) {
+            return { month, bytesUsed: 0 };
+        }
+        return { month, bytesUsed: bytesUsed < 0 ? 0 : bytesUsed };
+    }
+    catch {
+        return { month, bytesUsed: 0 };
+    }
+}
+function writeUsage(usage) {
+    const path = budgetPath();
+    ensureParentDir(path);
+    writeFileSync(path, `${JSON.stringify(usage, null, 2)}\n`, "utf-8");
+}
+export function recordBytes(n) {
+    if (!Number.isFinite(n) || n < 0)
+        return;
+    const usage = readUsage();
+    writeUsage({ ...usage, bytesUsed: usage.bytesUsed + n });
+}
+export function getUsage() {
+    return readUsage();
+}
+export function isOverSoftThreshold() {
+    return readUsage().bytesUsed >= LSE_SOFT_BYTE_THRESHOLD;
+}
+export function markExhausted() {
+    writeUsage({ month: currentMonth(), bytesUsed: LSE_MONTHLY_BYTE_CAP });
+}

package/dist/infra/rate-limiter.js

@@ -50,3 +50,4 @@ rateLimiter.configure("tradingview", 5, 1); // 5 burst, 1 req/s sustained
 rateLimiter.configure("polymarket", 10, 5); // 10 burst, 5 req/s sustained
 // SEC EDGAR fair-access guideline is 10 req/s; stay below it.
 rateLimiter.configure("sec_edgar", 5, 5); // 5 burst, 5 req/s sustained
+rateLimiter.configure("lse", 100, 1.66); // 100 req/min (free tier)