opencandle 0.1.1 → 0.3.0

package/README.md

@@ -1,55 +1,65 @@
 # 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.
+OpenCandle is a terminal-first financial data agent built with TypeScript and Pi. It fetches market, macro, options, fundamentals, sentiment, and portfolio data from real providers, then lets the model synthesize that data into an answer.
 
-## What This Does
+This repository is useful in two ways:
 
-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.
+- Run `opencandle` as an interactive CLI for market research
+- Extend OpenCandle with new tools, providers, or Pi-compatible add-on packages
 
-Type `analyze TSLA` and it runs a full 5-analyst breakdown — fundamentals, technicals, options positioning, sentiment, risk — then synthesizes a verdict.
+## What You Can Use It For
 
-[Pi](https://pi.dev/) powers the runtime, TUI, auth, and model selection. OpenCandle keeps its own user data in `~/.opencandle/`.
+- Quote and history lookups for stocks and crypto
+- Options chains with locally computed Greeks
+- Company fundamentals, earnings, and SEC filings
+- FRED macro series and Fear & Greed data
+- Reddit-based sentiment and discussion lookups
+- Portfolio tracking, watchlists, correlation, and risk analysis
+- Multi-step workflows such as `/analyze NVDA`
 
-## Getting Started
+OpenCandle is designed to fetch and format data. The model handles synthesis. Tool code should not invent financial conclusions or hardcode market numbers.
 
-### Standalone CLI
+## Install And Run
+
+Requires Node.js 20+.
+
+### CLI
 
 ```bash
 npm install -g opencandle
 opencandle
 
-# or run without installing globally
+# or 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
+On first run, OpenCandle walks you through model setup. You can rerun that flow later with `/setup`.
 
-| 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 |
+## Configuration
 
-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`.
+Model access comes from Pi. Market data providers are optional and additive.
 
-### State and Config
+| Key | Required | Used For |
+| --- | --- | --- |
+| `GEMINI_API_KEY` | No | Google models through Pi |
+| `OPENAI_API_KEY` | No | OpenAI models through Pi |
+| `ANTHROPIC_API_KEY` | No | Anthropic models through Pi |
+| `ALPHA_VANTAGE_API_KEY` | No | Fundamentals, earnings, financial statements |
+| `FRED_API_KEY` | No | Macro series such as rates, CPI, GDP, unemployment |
 
-- Pi runtime config and optional project overrides live in `.pi/` and `~/.pi/agent/...`.
-- OpenCandle finance-provider config lives in `~/.opencandle/config.json`:
+Yahoo Finance, CoinGecko, Reddit, SEC EDGAR, and Fear & Greed data do not require keys.
+
+OpenCandle stores its own user state in `~/.opencandle/` by default. Pi configuration stays in `.pi/` and `~/.pi/agent/`. The CLI should not depend on repo-local `.pi/extensions/`.
+
+Provider keys can also be stored in `~/.opencandle/config.json`:
 
 ```json
 {
@@ -64,87 +74,109 @@ Pi also supports OAuth-backed and custom providers through `~/.pi/agent/auth.jso
 }
 ```
 
-- 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.
+Environment variables override values from `~/.opencandle/config.json`. Set `OPENCANDLE_HOME` if you want OpenCandle state somewhere other than `~/.opencandle/`.
+
+## Basic Usage
 
-## Usage
+OpenCandle runs inside Pi's interactive terminal UI.
 
-OpenCandle now runs inside Pi's interactive TUI. Useful controls:
+Useful commands:
 
 ```text
-/model          Switch provider/model
-/login          Authenticate an OAuth-backed provider
-/setup          Rerun OpenCandle setup
-/analyze NVDA   Run the multi-analyst workflow
+/setup
+/login
+/model
+/analyze AAPL
 ```
 
-Natural-language prompts still work:
+Example prompts:
 
 ```text
-What's the price of AAPL?
+What is AAPL trading at?
 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)
+## Data Sources And Tool Coverage
 
-| 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 |
+| Area | Examples | Source |
+| --- | --- | --- |
+| Market data | quotes, history, ticker search, crypto price/history | Yahoo Finance, CoinGecko |
+| Options | chains, open interest, IV, Greeks | Yahoo Finance plus local calculations |
+| Fundamentals | overview, financials, earnings, DCF, company comparison | Alpha Vantage |
+| Macro | economic series, Fear & Greed | FRED, alternative.me |
+| Sentiment | Reddit, Twitter/X, and web sentiment with cross-source pipeline | Reddit JSON API, Twitter/X, DuckDuckGo, Brave |
+| Filings | SEC filing search | SEC EDGAR |
+| Portfolio | watchlist, prediction tracking, correlation, risk | Local state plus market data |
 
-## How It Works
+## Engineering Notes
 
-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.
+### Project Shape
 
+```text
+src/
+├── providers/    API clients
+├── tools/        Tool implementations by domain
+├── infra/        Cache, rate limiter, HTTP, browser, paths
+├── routing/      Intent classification and slot resolution
+├── workflows/    Multi-step workflow builders
+├── memory/       SQLite-backed state and retrieval
+├── analysts/     Multi-analyst orchestration
+├── pi/           Pi integration and session wiring
+└── index.ts      Public exports
 ```
-User prompt -> Pi session -> selected provider/model -> tool calls -> execute in parallel -> response
-                ^                                                                  |
-                |____________________ Pi session + model registry _________________|
+
+### Development Commands
+
+```bash
+npm start
+npm test
+npm run test:watch
+npm run test:e2e
+npm run test:e2e:cli
+npm run test:e2e:providers
 ```
 
-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
+`npm test` is the required baseline check after changes.
 
-## Test
+### Repository Rules That Matter
+
+- TDD is mandatory for behavior changes
+- Unit tests mock `globalThis.fetch` and use JSON fixtures
+- Use `cache` and `rateLimiter` for external calls
+- Tools fetch and format data; analysts and prompts synthesize
+- Keep typing strict and use `.js` extensions on relative imports
+
+### Public Package Exports
+
+Besides the CLI, the package exposes pieces for engineers building on top of OpenCandle:
+
+- `opencandle`
+- `opencandle/tool-kit`
+- `opencandle/infra`
+- `opencandle/types`
+- `opencandle/providers`
+
+If you want to add a new tool or publish an add-on package, start with [docs/build-a-tool.md](./docs/build-a-tool.md).
+
+## Testing The Agent
+
+For end-to-end agent driving with file-based IPC:
 
 ```bash
-npm test              # 208 unit tests
-npm run test:watch    # watch mode
+npx tsx tests/harness/manual-run.ts /tmp/opencandle-ipc "What is AAPL trading at?"
 ```
 
-## Project Docs
+The harness writes status and trace files into the IPC directory. See [tests/harness/README.md](./tests/harness/README.md) for the full flow.
 
-- 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
+## Project Docs
 
-- **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
+- [CONTRIBUTING.md](./CONTRIBUTING.md)
+- [docs/build-a-tool.md](./docs/build-a-tool.md)
+- [tests/harness/README.md](./tests/harness/README.md)
+- [CHANGELOG.md](./CHANGELOG.md)
+- [SECURITY.md](./SECURITY.md)
+- [LICENSE](./LICENSE)

package/dist/analysts/contracts.d.ts

@@ -0,0 +1,31 @@
+import type { AnalystOutput, AnalystSignal, DebateSide, DebateOutput } from "../runtime/workflow-types.js";
+import type { EvidenceRecord } from "../runtime/evidence.js";
+/** All analyst roles. */
+export type AnalystRole = "valuation" | "momentum" | "options" | "contrarian" | "risk";
+/** Evidence fields expected per analyst role. */
+export declare const ROLE_EXPECTED_EVIDENCE: Record<AnalystRole, string[]>;
+/**
+ * Parse an LLM response into a structured AnalystOutput.
+ * Falls back to raw text if parsing fails.
+ */
+export declare function parseAnalystOutput(role: string, responseText: string): AnalystOutput;
+/** Build a structured vote tally from analyst outputs. */
+export declare function tallyVotes(outputs: AnalystOutput[]): {
+    buy: number;
+    hold: number;
+    sell: number;
+    weightedConviction: number;
+    verdict: AnalystSignal;
+};
+/**
+ * Parse an LLM debate response into a structured DebateOutput.
+ * Eval/test helper only — not used in the live workflow path.
+ */
+export declare function parseDebateOutput(side: DebateSide, responseText: string): DebateOutput;
+/**
+ * Check whether analysts produced a BUY+SELL split.
+ * Eval/test helper only — not used in the live workflow path.
+ */
+export declare function isAnalystSplit(outputs: AnalystOutput[]): boolean;
+/** Collect all evidence from analyst outputs. */
+export declare function collectEvidence(outputs: AnalystOutput[]): EvidenceRecord[];

package/dist/analysts/contracts.js

@@ -0,0 +1,158 @@
+/** Evidence fields expected per analyst role. */
+export const ROLE_EXPECTED_EVIDENCE = {
+    valuation: ["P/E Ratio", "Forward P/E", "EPS", "Intrinsic Value", "Revenue Growth"],
+    momentum: ["RSI", "MACD", "SMA 50", "SMA 200", "Volume Trend"],
+    options: ["Put/Call Ratio", "IV Level", "Unusual Volume", "Max Pain"],
+    contrarian: ["Fear & Greed Index", "Reddit Sentiment", "Sentiment Score"],
+    risk: ["Annualized Volatility", "Sharpe Ratio", "Max Drawdown", "VaR 95%", "Position Size"],
+};
+/**
+ * Parse an LLM response into a structured AnalystOutput.
+ * Falls back to raw text if parsing fails.
+ */
+export function parseAnalystOutput(role, responseText) {
+    const signal = extractSignal(responseText);
+    const conviction = extractConviction(responseText);
+    const thesis = extractThesis(responseText);
+    return {
+        role,
+        signal: signal ?? "HOLD",
+        conviction: conviction ?? 5,
+        thesis: thesis ?? "",
+        evidence: [],
+        rawText: responseText,
+    };
+}
+function extractSignal(text) {
+    const match = text.match(/SIGNAL:\s*(BUY|HOLD|SELL)/i);
+    if (match)
+        return match[1].toUpperCase();
+    return null;
+}
+function extractConviction(text) {
+    const match = text.match(/CONVICTION:\s*(\d+)/i);
+    if (match) {
+        const value = parseInt(match[1], 10);
+        if (value >= 1 && value <= 10)
+            return value;
+    }
+    return null;
+}
+function extractThesis(text) {
+    const match = text.match(/THESIS:\s*(.+)/i);
+    return match ? match[1].trim() : null;
+}
+/** Build a structured vote tally from analyst outputs. */
+export function tallyVotes(outputs) {
+    let buy = 0;
+    let hold = 0;
+    let sell = 0;
+    let totalWeight = 0;
+    let weightedSum = 0;
+    for (const output of outputs) {
+        switch (output.signal) {
+            case "BUY":
+                buy++;
+                break;
+            case "HOLD":
+                hold++;
+                break;
+            case "SELL":
+                sell++;
+                break;
+        }
+        totalWeight += output.conviction;
+        const signalValue = output.signal === "BUY" ? 1 : output.signal === "SELL" ? -1 : 0;
+        weightedSum += signalValue * output.conviction;
+    }
+    const weightedConviction = totalWeight > 0
+        ? Math.round((totalWeight / outputs.length) * 10) / 10
+        : 0;
+    let verdict;
+    if (weightedSum > 0)
+        verdict = "BUY";
+    else if (weightedSum < 0)
+        verdict = "SELL";
+    else
+        verdict = "HOLD";
+    return { buy, hold, sell, weightedConviction, verdict };
+}
+/**
+ * Parse an LLM debate response into a structured DebateOutput.
+ * Eval/test helper only — not used in the live workflow path.
+ */
+export function parseDebateOutput(side, responseText) {
+    // Detect skipped rebuttal
+    if (/^rebuttal skipped/i.test(responseText.trim())) {
+        return {
+            side,
+            thesis: "",
+            keyRisk: "",
+            concessions: [],
+            remainingConviction: 0,
+            evidence: [],
+            rawText: responseText,
+        };
+    }
+    const thesis = extractDebateThesis(side, responseText);
+    const keyRisk = extractKeyRisk(side, responseText);
+    const concessions = extractConcessions(responseText);
+    const remainingConviction = extractRemainingConviction(responseText);
+    return {
+        side,
+        thesis,
+        keyRisk,
+        concessions,
+        remainingConviction,
+        evidence: [],
+        rawText: responseText,
+    };
+}
+function extractDebateThesis(side, text) {
+    const label = side === "bull" ? "BULL THESIS" : "BEAR THESIS";
+    const match = text.match(new RegExp(`${label}:\\s*(.+)`, "i"));
+    return match ? match[1].trim() : "";
+}
+function extractKeyRisk(side, text) {
+    if (side === "bear") {
+        const match = text.match(/WHAT WOULD CHANGE MY MIND:\s*(.+)/i);
+        return match ? match[1].trim() : "";
+    }
+    const match = text.match(/KEY RISK(?:\s+TO THIS THESIS)?:\s*(.+)/i);
+    return match ? match[1].trim() : "";
+}
+function extractConcessions(text) {
+    const match = text.match(/CONCESSIONS:\s*([\s\S]*?)(?=REMAINING CONVICTION:|$)/i);
+    if (!match)
+        return [];
+    return match[1]
+        .split("\n")
+        .map((line) => line.replace(/^[-*•]\s*/, "").trim())
+        .filter(Boolean);
+}
+function extractRemainingConviction(text) {
+    const match = text.match(/REMAINING CONVICTION:\s*(\d+)/i);
+    if (match) {
+        const value = parseInt(match[1], 10);
+        if (value >= 1 && value <= 10)
+            return value;
+    }
+    return 0;
+}
+/**
+ * Check whether analysts produced a BUY+SELL split.
+ * Eval/test helper only — not used in the live workflow path.
+ */
+export function isAnalystSplit(outputs) {
+    const votes = tallyVotes(outputs);
+    return votes.buy > 0 && votes.sell > 0;
+}
+/** Collect all evidence from analyst outputs. */
+export function collectEvidence(outputs) {
+    const evidence = [];
+    for (const output of outputs) {
+        evidence.push(...output.evidence);
+    }
+    return evidence;
+}
+//# sourceMappingURL=contracts.js.map

package/dist/analysts/contracts.js.map

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

package/dist/analysts/orchestrator.d.ts

@@ -1,7 +1,16 @@
 export type AnalystRole = "valuation" | "momentum" | "options" | "contrarian" | "risk";
+export declare function buildBullPrompt(symbol: string): string;
+export declare function buildBearPrompt(symbol: string): string;
+export declare function buildRebuttalPrompt(symbol: string): string;
+export declare function buildSynthesisPrompt(symbol: string): string;
 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 interface ComprehensiveAnalysisOptions {
+    debate?: boolean;
+}
+export declare function getComprehensiveAnalysisPrompts(symbol: string, options?: ComprehensiveAnalysisOptions): string[];
+import type { WorkflowDefinition } from "../runtime/prompt-step.js";
+export declare function buildComprehensiveAnalysisDefinition(symbol: string, options?: ComprehensiveAnalysisOptions): WorkflowDefinition;
+export declare function runComprehensiveAnalysis(enqueueFollowUp: (prompt: string) => void, symbol: string, options?: ComprehensiveAnalysisOptions): void;
 export declare function isAnalysisRequest(input: string): {
     match: boolean;
     symbol?: string;