opencandle 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kahtaf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# OpenCandle
+
+A financial agent that talks to markets. Ask it for stock prices, options chains with Greeks, macro data, sentiment — it fetches real data, computes analytics locally, and gives you actionable answers.
+
+## What This Does
+
+OpenCandle is an AI-powered terminal agent for investors and traders. Instead of switching between Yahoo Finance, FRED, Reddit, and a spreadsheet, you ask one agent and it chains the right tools together. It computes technical indicators and options Greeks locally (Black-Scholes), so there's no API dependency for math.
+
+Type `analyze TSLA` and it runs a full 5-analyst breakdown — fundamentals, technicals, options positioning, sentiment, risk — then synthesizes a verdict.
+
+[Pi](https://pi.dev/) powers the runtime, TUI, auth, and model selection. OpenCandle keeps its own user data in `~/.opencandle/`.
+
+## Getting Started
+
+### Standalone CLI
+
+```bash
+npm install -g opencandle
+opencandle
+
+# or run without installing globally
+npx opencandle@latest
+```
+
+On first run, OpenCandle guides you through AI model setup before chat starts. If you want to rerun that flow later, use `/setup`.
+
+### From Source
+
+```bash
+npm install
+cp .env.example .env
+# Add any LLM env vars you want to use locally (for example GEMINI_API_KEY)
+npm start
+```
+
+### API Keys
+
+| Key | Required | Free Tier | What It Unlocks |
+|-----|----------|-----------|-----------------|
+| `GEMINI_API_KEY` | No | Yes | Google Gemini via Pi auth/model registry |
+| `OPENAI_API_KEY` | No | Paid | OpenAI models via Pi auth/model registry |
+| `ANTHROPIC_API_KEY` | No | Paid | Anthropic models via Pi auth/model registry |
+| `ALPHA_VANTAGE_API_KEY` | No | 25 req/day | Company fundamentals, earnings, financials |
+| `FRED_API_KEY` | No | Generous | Fed rates, CPI, GDP, unemployment, yield curve |
+
+Yahoo Finance, CoinGecko, Reddit, and Fear & Greed Index need no keys.
+Pi also supports OAuth-backed and custom providers through `~/.pi/agent/auth.json`, `/login`, `/model`, and `~/.pi/agent/models.json`.
+
+### State and Config
+
+- Pi runtime config and optional project overrides live in `.pi/` and `~/.pi/agent/...`.
+- OpenCandle finance-provider config lives in `~/.opencandle/config.json`:
+
+```json
+{
+  "providers": {
+    "alphaVantage": {
+      "apiKey": "..."
+    },
+    "fred": {
+      "apiKey": "..."
+    }
+  }
+}
+```
+
+- Environment variables still work and override `~/.opencandle/config.json`.
+- OpenCandle user data lives in `~/.opencandle/`:
+  - `~/.opencandle/watchlist.json`
+  - `~/.opencandle/portfolio.json`
+  - `~/.opencandle/predictions.json`
+  - `~/.opencandle/state.db`
+  - `~/.opencandle/logs/...`
+- The published CLI should work from any directory without depending on a repo-local `.pi/extensions/...` file. Project `.pi/` remains optional for user overrides.
+
+## Usage
+
+OpenCandle now runs inside Pi's interactive TUI. Useful controls:
+
+```text
+/model          Switch provider/model
+/login          Authenticate an OAuth-backed provider
+/setup          Rerun OpenCandle setup
+/analyze NVDA   Run the multi-analyst workflow
+```
+
+Natural-language prompts still work:
+
+```text
+What's the price of AAPL?
+Get the options chain for TSLA expiring April 24
+Show me MSFT puts with Greeks
+What's the Fear and Greed index?
+Get the fed funds rate from FRED
+Add 100 shares of NVDA at 120 to my portfolio, then show my portfolio
+Run risk analysis on SPY
+analyze AAPL
+```
+
+## Tools (23)
+
+| Category | Tools | Data Source |
+|----------|-------|------------|
+| **Market Data** | `search_ticker`, `get_stock_quote`, `get_stock_history`, `get_crypto_price`, `get_crypto_history` | Yahoo Finance, CoinGecko |
+| **Options** | `get_option_chain` — strikes, bids/asks, volume, OI, IV, computed Greeks | Yahoo Finance + Black-Scholes |
+| **Fundamentals** | `get_company_overview`, `get_financials`, `get_earnings`, `compute_dcf`, `compare_companies`, `get_sec_filings` | Alpha Vantage, SEC EDGAR |
+| **Technical** | `get_technical_indicators`, `backtest_strategy` — SMA, EMA, RSI, MACD, Bollinger Bands, backtesting | Computed locally from OHLCV |
+| **Macro** | `get_economic_data`, `get_fear_greed` | FRED, alternative.me |
+| **Sentiment** | `get_reddit_sentiment`, `get_reddit_discussions` | Reddit JSON API |
+| **Portfolio** | `track_portfolio`, `analyze_risk`, `manage_watchlist`, `analyze_correlation`, `track_prediction` | Yahoo Finance + local math |
+
+## How It Works
+
+Built on [Pi-mono](https://github.com/badlogic/pi-mono)'s `pi-coding-agent` SDK and TUI, with OpenCandle loaded as a bundled finance-only Pi extension. Tools are defined with [TypeBox](https://github.com/sinclairzx81/typebox) schemas and registered through Pi's extension system.
+
+```
+User prompt -> Pi session -> selected provider/model -> tool calls -> execute in parallel -> response
+                ^                                                                  |
+                |____________________ Pi session + model registry _________________|
+```
+
+Key architectural choices:
+- **Local computation** over API calls for math (indicators, Greeks, risk metrics)
+- **Stealth browser fallback** via [Camoufox](https://github.com/daijro/camoufox) when Yahoo rate-limits Node.js `fetch`
+- **TTL caching + token bucket rate limiting** per provider
+- **Pi-native auth/model flow** via `/model`, `/login`, `auth.json`, and `models.json`
+- **Global OpenCandle state** under `~/.opencandle/`, separate from Pi config
+- **Multi-analyst orchestration** via Pi extension commands and follow-up message hooks
+
+## Test
+
+```bash
+npm test              # 208 unit tests
+npm run test:watch    # watch mode
+```
+
+## Project Docs
+
+- OSS launch and npm release plan: [docs/production-plan.md](https://github.com/Kahtaf/OpenCandle/blob/main/docs/production-plan.md)
+- Contributor guide: [CONTRIBUTING.md](https://github.com/Kahtaf/OpenCandle/blob/main/CONTRIBUTING.md)
+- Security policy: [SECURITY.md](https://github.com/Kahtaf/OpenCandle/blob/main/SECURITY.md)
+- Release history: [CHANGELOG.md](https://github.com/Kahtaf/OpenCandle/blob/main/CHANGELOG.md)
+
+## Tech Stack
+
+- **Runtime**: TypeScript, Node.js
+- **LLM**: Pi model registry with Gemini, OpenAI, Anthropic, and custom providers
+- **Browser**: Camoufox (anti-detection Firefox for scraping fallback)
+- **Testing**: Vitest with fixture-mocked `fetch`
+- **No frameworks**: Raw providers, no LangChain/LlamaIndex

package/dist/analysts/orchestrator.d.ts

@@ -0,0 +1,9 @@
+export type AnalystRole = "valuation" | "momentum" | "options" | "contrarian" | "risk";
+export declare function getInitialAnalysisPrompt(symbol: string): string;
+export declare function getComprehensiveAnalysisPrompts(symbol: string): string[];
+export declare function runComprehensiveAnalysis(enqueueFollowUp: (prompt: string) => void, symbol: string): void;
+export declare function isAnalysisRequest(input: string): {
+    match: boolean;
+    symbol?: string;
+};
+export declare function normalizeSymbol(input: string): string | undefined;

package/dist/analysts/orchestrator.js

@@ -0,0 +1,100 @@
+const SYMBOL_CAPTURE = "(\\$?[A-Za-z]{1,5}(?:[./-][A-Za-z]{1,2})?)";
+const NORMALIZED_SYMBOL_PATTERN = /^[A-Z]{1,5}(?:[./-][A-Z]{1,2})?$/;
+const VOTING_INSTRUCTION = `
+
+End your analysis with this exact format:
+SIGNAL: BUY | HOLD | SELL
+CONVICTION: [1-10]
+THESIS: [one sentence summary of your position]`;
+const EXECUTION_GUARDRAILS = `
+Execution rules:
+- Reuse tool outputs that were already fetched earlier in the session. Do not call the same tool again for the same symbol unless you need a missing field.
+- If a required provider returns unavailable or missing data, stop that leg quickly, label the missing metrics as unavailable, and continue with the remaining evidence.
+- Do not retry the same failing fundamentals call multiple times.`;
+const ANALYST_PROMPTS = {
+    valuation: (symbol) => `**[Valuation Analyst]** You are a Damodaran-style valuation analyst. Your approach: connect the company's narrative to numbers, then compute intrinsic value. Analyze ${symbol}:
+1. Start with get_company_overview for P/E, forward P/E, EPS, profit margin, and market cap.
+2. If overview data is available, use get_financials for revenue, income, and free cash flow trends across years.
+3. If financial statements are available, use get_earnings for EPS surprise patterns and growth trajectory.
+4. Only use compute_dcf once you have the inputs needed to estimate intrinsic value.
+Assess: What growth rate is the market implicitly pricing in? Is the current price above or below your intrinsic value range? Cite specific numbers with their source tool. Keep reasoning data-driven — every claim must reference a fetched number.${EXECUTION_GUARDRAILS}${VOTING_INSTRUCTION}`,
+    momentum: (symbol) => `**[Momentum Analyst]** You are a CAN SLIM-style momentum analyst. Price action and volume are your primary evidence. Analyze ${symbol}:
+1. Use get_stock_history with 1y range, then get_technical_indicators.
+2. Focus on: Is price making new highs or breaking down from a base? Is OBV rising (volume confirming) or diverging? Where is price relative to VWAP?
+3. Check RSI (overbought >70 / oversold <30) and MACD histogram direction.
+4. Identify key support/resistance from Bollinger Bands and SMA(20)/SMA(50).
+5. Use get_earnings to check if earnings are accelerating quarter over quarter.
+State specific price levels. A breakout on rising volume is bullish; a breakdown on high volume is bearish. No vague language — cite the numbers.${EXECUTION_GUARDRAILS}${VOTING_INSTRUCTION}`,
+    options: (symbol) => `**[Options Analyst]** You analyze what the derivatives market is pricing in. Analyze ${symbol}:
+1. Use get_option_chain to review the full chain with strikes, volume, open interest, IV, and Greeks.
+2. Compute the put/call ratio from volume data — above 1.0 is bearish bias, below 0.7 is bullish.
+3. Look for unusually high volume contracts (>3x average OI) that signal institutional positioning.
+4. Note the overall IV level — is it elevated (expecting a move) or compressed (quiet period)?
+5. Check if smart money is positioning via deep ITM or OTM options with high volume.
+What is the options market pricing in that the stock price alone doesn't show?${EXECUTION_GUARDRAILS}${VOTING_INSTRUCTION}`,
+    contrarian: (symbol) => `**[Contrarian Analyst]** You are a Burry-style contrarian. Your job is to find what the crowd is missing. Be terse and data-driven — cite concrete numbers like "FCF yield 14.7%" or "P/E 8.3x vs sector 22x." Analyze ${symbol}:
+1. Use get_fear_greed for overall market mood — extreme readings signal opportunity.
+2. Use get_reddit_sentiment on wallstreetbets and stocks — check the sentiment score. Extreme bullishness from retail is a warning; extreme bearishness may be opportunity.
+3. Use get_reddit_discussions for ${symbol} to gauge retail narrative.
+4. Cross-reference: Is sentiment overly bullish while fundamentals (revenue, margins, FCF) are deteriorating? Is everyone bearish while the numbers quietly improve?
+5. Reuse get_company_overview or other fundamentals already fetched earlier in the session if available. If fundamentals are unavailable, say so and base the contrarian view on sentiment and price only.
+Where is the consensus wrong? What is the market over-pricing or under-pricing?${EXECUTION_GUARDRAILS}${VOTING_INSTRUCTION}`,
+    risk: (symbol) => `**[Risk Manager]** You are the final check before capital is deployed. Your job is to quantify downside, not to have an opinion on direction. Analyze ${symbol}:
+1. Use analyze_risk to compute annualized volatility, Sharpe ratio, max drawdown, and VaR(95%).
+2. Position sizing: Using the 2% portfolio risk rule, compute max position size. Formula: position_size = (0.02 * portfolio_value) / (entry_price * stop_loss_pct). Assume $100K portfolio.
+3. Risk/reward: Is potential upside at least 2x the max drawdown? If not, the trade is unfavorable regardless of thesis.
+4. Correlation: If this is in a portfolio, would it add diversification or concentration risk?
+5. Scenario analysis: What is the max realistic downside in a 1-sigma and 2-sigma move?
+Be quantitative. Every assessment must include a number.${EXECUTION_GUARDRAILS}${VOTING_INSTRUCTION}`,
+};
+const SYNTHESIS_PROMPT = (symbol) => `**[Synthesis]** You have received five analyst signals above for ${symbol}. Tally the SIGNAL votes (BUY/HOLD/SELL) and weight them by CONVICTION scores. Then provide:
+1. **Vote Tally**: X BUY, Y HOLD, Z SELL — weighted average conviction
+2. **Verdict**: Buy, Hold, or Sell — based on the signal consensus
+3. **Key thesis** in 2-3 sentences
+4. **Bull case** — what could go right
+5. **Bear case** — what could go wrong
+6. **Key levels** — entry, stop-loss, and target prices
+7. **Position sizing recommendation** based on risk profile
+
+Be direct and actionable. This is your final word on ${symbol}.`;
+const VALIDATION_PROMPT = (symbol) => `**[Validation Check]** Review your complete analysis of ${symbol} above. For each specific number you cited (price, P/E, revenue, RSI, intrinsic value, etc.), verify it matches the tool output data you received. Flag any inconsistencies. If you stated a number without fetching it first, call that out as UNVERIFIED. Output: VALIDATED if all numbers check out, or list specific corrections needed.`;
+export function getInitialAnalysisPrompt(symbol) {
+    return `Begin comprehensive analysis of ${symbol}. Start by getting the current stock quote.`;
+}
+export function getComprehensiveAnalysisPrompts(symbol) {
+    const roles = ["valuation", "momentum", "options", "contrarian", "risk"];
+    const prompts = [getInitialAnalysisPrompt(symbol)];
+    for (const role of roles) {
+        prompts.push(ANALYST_PROMPTS[role](symbol));
+    }
+    prompts.push(SYNTHESIS_PROMPT(symbol));
+    prompts.push(VALIDATION_PROMPT(symbol));
+    return prompts;
+}
+export function runComprehensiveAnalysis(enqueueFollowUp, symbol) {
+    for (const prompt of getComprehensiveAnalysisPrompts(symbol).slice(1)) {
+        enqueueFollowUp(prompt);
+    }
+}
+export function isAnalysisRequest(input) {
+    const patterns = [
+        new RegExp(`^analyze\\s+${SYMBOL_CAPTURE}\\s*$`, "i"),
+        new RegExp(`^full\\s+analysis\\s+(?:of\\s+)?${SYMBOL_CAPTURE}\\s*$`, "i"),
+        new RegExp(`^deep\\s+dive\\s+(?:on\\s+)?${SYMBOL_CAPTURE}\\s*$`, "i"),
+    ];
+    for (const pattern of patterns) {
+        const match = input.match(pattern);
+        if (match) {
+            return { match: true, symbol: match[1].replace(/\$/g, "").toUpperCase() };
+        }
+    }
+    return { match: false };
+}
+export function normalizeSymbol(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return undefined;
+    const candidate = trimmed.replace(/\$/g, "").toUpperCase();
+    return NORMALIZED_SYMBOL_PATTERN.test(candidate) ? candidate : undefined;
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/analysts/orchestrator.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { AuthStorage, DefaultPackageManager, InteractiveMode, ModelRegistry, SettingsManager, getAgentDir, initTheme, } from "@mariozechner/pi-coding-agent";
+import { createOpenCandleSession } from "./pi/session.js";
+import { loadEnv } from "./config.js";
+async function handlePackageCommand(args, cwd, agentDir) {
+    const [command, ...rest] = args;
+    if (!command ||
+        !["install", "remove", "uninstall", "list", "update"].includes(command)) {
+        return false;
+    }
+    const settingsManager = SettingsManager.create(cwd, agentDir);
+    const packageManager = new DefaultPackageManager({
+        cwd,
+        agentDir,
+        settingsManager,
+    });
+    packageManager.setProgressCallback((event) => {
+        if (event.type === "start" || event.type === "progress") {
+            process.stdout.write(`${event.message}\n`);
+        }
+    });
+    const source = rest.find((a) => !a.startsWith("-"));
+    const local = rest.includes("-l") || rest.includes("--local");
+    switch (command === "uninstall" ? "remove" : command) {
+        case "install": {
+            if (!source) {
+                console.error("Usage: opencandle install <source> [-l]");
+                process.exitCode = 1;
+                return true;
+            }
+            await packageManager.install(source, { local });
+            packageManager.addSourceToSettings(source, { local });
+            console.log(`Installed ${source}`);
+            return true;
+        }
+        case "remove": {
+            if (!source) {
+                console.error("Usage: opencandle remove <source> [-l]");
+                process.exitCode = 1;
+                return true;
+            }
+            await packageManager.remove(source, { local });
+            const removed = packageManager.removeSourceFromSettings(source, {
+                local,
+            });
+            if (!removed) {
+                console.error(`No matching package found for ${source}`);
+                process.exitCode = 1;
+            }
+            else {
+                console.log(`Removed ${source}`);
+            }
+            return true;
+        }
+        case "list": {
+            const globalPkgs = settingsManager.getGlobalSettings().packages ?? [];
+            const projectPkgs = settingsManager.getProjectSettings().packages ?? [];
+            if (globalPkgs.length === 0 && projectPkgs.length === 0) {
+                console.log("No packages installed.");
+                return true;
+            }
+            if (globalPkgs.length > 0) {
+                console.log("User packages:");
+                for (const pkg of globalPkgs) {
+                    const s = typeof pkg === "string" ? pkg : pkg.source;
+                    const path = packageManager.getInstalledPath(s, "user");
+                    console.log(`  ${s}${path ? `\n    ${path}` : ""}`);
+                }
+            }
+            if (projectPkgs.length > 0) {
+                console.log("Project packages:");
+                for (const pkg of projectPkgs) {
+                    const s = typeof pkg === "string" ? pkg : pkg.source;
+                    const path = packageManager.getInstalledPath(s, "project");
+                    console.log(`  ${s}${path ? `\n    ${path}` : ""}`);
+                }
+            }
+            return true;
+        }
+        case "update": {
+            await packageManager.update(source);
+            console.log(source ? `Updated ${source}` : "All packages updated.");
+            return true;
+        }
+    }
+    return false;
+}
+async function main() {
+    const { positionals } = parseArgs({ allowPositionals: true, strict: false });
+    const cwd = process.cwd();
+    const agentDir = getAgentDir();
+    if (await handlePackageCommand(positionals, cwd, agentDir)) {
+        return;
+    }
+    // Default: start the OpenCandle interactive agent
+    loadEnv();
+    const settingsManager = SettingsManager.create(cwd, agentDir);
+    const authStorage = AuthStorage.create();
+    const modelRegistry = ModelRegistry.create(authStorage);
+    const shouldSuppressFallbackMessage = modelRegistry.getAvailable().length === 0;
+    initTheme(settingsManager.getTheme(), true);
+    const { session, modelFallbackMessage } = await createOpenCandleSession({
+        cwd,
+        settingsManager,
+        authStorage,
+        modelRegistry,
+    });
+    try {
+        const interactiveMode = new InteractiveMode(session, {
+            modelFallbackMessage: shouldSuppressFallbackMessage
+                ? undefined
+                : modelFallbackMessage,
+        });
+        await interactiveMode.run();
+    }
+    finally {
+        session.dispose();
+    }
+}
+await main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+export interface Config {
+    alphaVantageApiKey?: string;
+    fredApiKey?: string;
+}
+export interface OpenCandleFileConfig {
+    providers?: {
+        alphaVantage?: {
+            apiKey?: string;
+        };
+        fred?: {
+            apiKey?: string;
+        };
+    };
+}
+export interface FinanceProviderReadiness {
+    hasAlphaVantage: boolean;
+    hasFred: boolean;
+}
+export declare function loadEnv(path?: string): void;
+export declare function loadFileConfig(path?: string): OpenCandleFileConfig;
+export declare function saveFileConfig(config: OpenCandleFileConfig, path?: string): void;
+export declare function getFinanceProviderReadiness(path?: string): FinanceProviderReadiness;
+export declare function loadConfig(): Config;
+export declare function getConfig(): Config;

package/dist/config.js

@@ -0,0 +1,76 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { ensureParentDir, getConfigPath } from "./infra/opencandle-paths.js";
+export function loadEnv(path = ".env") {
+    let content;
+    try {
+        content = readFileSync(path, "utf-8");
+    }
+    catch {
+        return;
+    }
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        const value = trimmed.slice(eqIndex + 1).trim();
+        if (key && value) {
+            process.env[key] = value;
+        }
+    }
+}
+let cachedConfig = null;
+function resolveConfig(fileConfig) {
+    return {
+        alphaVantageApiKey: process.env.ALPHA_VANTAGE_API_KEY ?? fileConfig.providers?.alphaVantage?.apiKey,
+        fredApiKey: process.env.FRED_API_KEY ?? fileConfig.providers?.fred?.apiKey,
+    };
+}
+export function loadFileConfig(path = getConfigPath()) {
+    if (!existsSync(path)) {
+        return {};
+    }
+    let content;
+    try {
+        content = readFileSync(path, "utf-8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to read OpenCandle config at ${path}: ${message}`);
+    }
+    try {
+        const parsed = JSON.parse(content);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid OpenCandle config at ${path}: ${message}`);
+    }
+}
+export function saveFileConfig(config, path = getConfigPath()) {
+    ensureParentDir(path);
+    writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+}
+export function getFinanceProviderReadiness(path = getConfigPath()) {
+    loadEnv();
+    const config = resolveConfig(loadFileConfig(path));
+    return {
+        hasAlphaVantage: Boolean(config.alphaVantageApiKey),
+        hasFred: Boolean(config.fredApiKey),
+    };
+}
+export function loadConfig() {
+    loadEnv();
+    cachedConfig = resolveConfig(loadFileConfig());
+    return cachedConfig;
+}
+export function getConfig() {
+    if (!cachedConfig) {
+        return loadConfig();
+    }
+    return cachedConfig;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createOpenCandleSession, type CreateOpenCandleSessionOptions } from "./pi/session.js";
+export { default as openCandleExtension } from "./pi/opencandle-extension.js";
+export { agentToolToPiTool, getOpenCandleToolDefinitions } from "./pi/tool-adapter.js";
+export { registerOpenCandleTools } from "./tool-kit.js";
+export { getAllTools } from "./tools/index.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { createOpenCandleSession } from "./pi/session.js";
+export { default as openCandleExtension } from "./pi/opencandle-extension.js";
+export { agentToolToPiTool, getOpenCandleToolDefinitions } from "./pi/tool-adapter.js";
+export { registerOpenCandleTools } from "./tool-kit.js";
+export { getAllTools } from "./tools/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAuC,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/infra/browser.d.ts

@@ -0,0 +1,27 @@
+import type { Page } from "playwright-core";
+export declare const StealthBrowser: {
+    /**
+     * Navigate to a URL, run a JS function in the page context, and return the result.
+     */
+    evaluate<T>(url: string, fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * Fetch JSON from a URL using the browser's session (cookies, TLS fingerprint).
+     * Useful for APIs that block Node.js fetch but allow real browsers.
+     */
+    fetchJson<T>(url: string, options?: {
+        cookies?: string;
+    }): Promise<T>;
+    /**
+     * Run a custom async function in the browser page context.
+     * The page must already be on a relevant domain for cookies to work.
+     */
+    run<T>(fn: (page: Page) => Promise<T>): Promise<T>;
+    /**
+     * Navigate to a URL and establish session cookies for that domain.
+     */
+    initSession(url: string): Promise<void>;
+    /**
+     * Close the browser. It will be re-launched on next use.
+     */
+    close(): Promise<void>;
+};