horizon-code 0.1.0

package/src/components/tutorial-panel.ts

@@ -0,0 +1,680 @@
+// Tutorial panel — split-view panel with tabbed guide content
+// Rendered as markdown with syntax highlighting
+
+import {
+  BoxRenderable,
+  TextRenderable,
+  ScrollBoxRenderable,
+  MarkdownRenderable,
+  SyntaxStyle,
+  type CliRenderer,
+} from "@opentui/core";
+import { COLORS } from "../theme/colors.ts";
+
+const syntaxStyle = SyntaxStyle.create();
+
+type TutorialTab = "start" | "overview" | "research" | "strategy" | "portfolio" | "settings" | "commands" | "tips";
+
+const TAB_LIST: { id: TutorialTab; label: string }[] = [
+  { id: "start", label: "Start" },
+  { id: "overview", label: "Modes" },
+  { id: "research", label: "Research" },
+  { id: "strategy", label: "Strategy" },
+  { id: "portfolio", label: "Portfolio" },
+  { id: "settings", label: "Config" },
+  { id: "commands", label: "Cmds" },
+  { id: "tips", label: "Tips" },
+];
+
+const CONTENT: Record<TutorialTab, string> = {
+  start: `# First Steps
+
+Welcome to Horizon. Here's how to get started in 5 minutes.
+
+---
+
+## Step 1: Research a market
+
+You're in **Research mode** by default. Just ask:
+
+> "What prediction markets are there about bitcoin?"
+
+The AI searches **live Polymarket data** and shows results with
+prices, volume, and liquidity. Try:
+
+- *"Show me the order book for that first one"*
+- *"What do whales think about this market?"*
+- *"Calculate the EV if I think it's 60% likely"*
+
+---
+
+## Step 2: Build a strategy
+
+Press **Ctrl+R** to switch to **Strategy mode**. Then:
+
+> "Build me a market making strategy for this market"
+
+The AI researches the market, writes Python code using the
+**Horizon SDK**, validates it, and opens the **code panel** (Ctrl+G)
+showing your strategy with syntax highlighting.
+
+Iterate: *"Make the spread tighter"* or *"Add inventory skew"*
+
+---
+
+## Step 3: Backtest it
+
+> "Backtest this strategy"
+
+Runs \`hz.backtest()\` with real SDK metrics — Sharpe ratio,
+drawdown, win rate, profit factor, equity curve.
+
+---
+
+## Step 4: Deploy
+
+> "Deploy it in paper mode"
+
+Your strategy goes live on the Horizon cloud in paper trading mode.
+Switch to **Portfolio mode** (Ctrl+R) to monitor it.
+
+---
+
+## Step 5: Customize
+
+- **/settings** — intelligence level, themes, sound, auto-compact
+- **/hooks** — run custom bash commands before/after strategy actions
+- **/env add ALPACA_KEY sk-xxx** — store encrypted API keys for SDK integrations
+
+---
+
+## Keyboard cheat sheet
+
+| Key | What it does |
+|-----|-------------|
+| **Ctrl+R** | Switch mode (research/strategy/portfolio) |
+| **Ctrl+N** | New chat |
+| **Ctrl+L / Ctrl+H** | Switch between open chats |
+| **Ctrl+W** | Close current chat |
+| **Ctrl+E** | Open chat sidebar |
+| **Ctrl+D** | Open bots panel |
+| **Ctrl+G** | Toggle code panel |
+| **Esc** | Stop generation / close panels |
+
+---
+
+## Plans & limits
+
+| | **Free** | **Pro** | **Ultra** |
+|---|---------|---------|-----------|
+| Model | Fast | Fast + Standard + Pro | All + Ultra |
+| Tokens/5h | 50K | 500K | 5M |
+| Sentiment | - | Yes | Yes |
+| Knowledge | - | Yes | Yes |
+
+Upgrade at **mathematicalcompany.com/pricing**
+`,
+
+  overview: `# Horizon
+
+Horizon is a terminal-native AI trading assistant for **prediction markets**.
+Research, build strategies, and manage your portfolio — all from the terminal.
+
+---
+
+## Quick Start
+
+1. **Research** — just ask: *"What's happening with Iran?"*
+2. **Strategy** — switch with **Ctrl+R**: *"Build me a market maker"*
+3. **Portfolio** — switch again: *"Show my deployments"*
+
+The AI has **live tools** — it searches real markets, writes real code,
+backtests with real metrics. Never answers from memory.
+
+---
+
+## Three Modes
+
+Switch with **Ctrl+R** or \`/mode\`
+
+**Research** — 13 live data tools. Search markets, order books,
+whale activity, sentiment, EV calculator, cross-platform comparison.
+
+**Strategy** — Full coding partner. Writes Python with the Horizon SDK,
+validates, backtests with \`hz.backtest()\`, runs locally in sandbox,
+deploys to the cloud. Code panel shows syntax-highlighted source.
+
+**Portfolio** — Monitor live deployments. P&L, positions, orders,
+drawdown. Start, stop, restart from the bots panel.
+
+---
+
+## Layout
+
+| Area | Key | What it does |
+|------|-----|-------------|
+| **Chat** | — | Left side, talk to the AI |
+| **Code panel** | Ctrl+G | Right side, strategy code + logs |
+| **Sessions** | Ctrl+E | Left overlay, manage chats |
+| **Bots** | Ctrl+D | Right overlay, monitor strategies |
+| **Tutorial** | /tutorial | This guide |
+| **Settings** | /settings | Configuration |
+
+---
+
+## Authentication
+
+\`/login\` opens your browser — sign in with **Google** or email.
+Sessions, strategies, and settings sync across devices.
+`,
+
+  research: `# Research Mode
+
+The AI has 13 tools that fetch **live data** from Polymarket, Kalshi,
+and the web. It never answers from memory — always calls tools.
+
+## Market Discovery
+
+Ask about any topic and the AI searches 200+ active markets:
+
+- "What's happening with Iran?"
+- "Show me crypto markets"
+- "Any sports betting markets?"
+
+## Deep Analysis
+
+Once you find a market, dig deeper:
+
+- **Event detail** — sub-markets, prices, spreads, volume, sparkline
+- **Order book** — bid/ask depth with visual bars
+- **Price history** — sparkline charts at any interval (1h to max)
+- **Whale tracker** — large trades, smart money flow direction
+- **Sentiment** — news analysis with bull/bear gauge
+- **Volatility** — realized vol, regime detection (high/normal/low)
+
+## Quantitative Tools
+
+- **EV Calculator** — expected value, edge, Kelly criterion sizing
+- **Probability** — joint and conditional probabilities between markets
+- **Cross-platform** — compare Polymarket vs Kalshi prices for arbitrage
+
+## Tool Chaining
+
+The AI remembers market slugs from previous results. Say "tell me more
+about the first one" and it uses the slug without re-searching.
+
+## Widgets
+
+Tool results render as rich terminal widgets — not raw text. Order
+books show depth bars, sparklines show price trends, sentiment shows
+a gauge. The AI adds 1-2 sentences of insight after each widget.
+`,
+
+  strategy: `# Strategy Mode
+
+Build trading strategies with the Horizon SDK. The AI is a coding
+partner — it researches markets, writes code, validates, backtests,
+runs locally, and deploys to the cloud.
+
+## Workflow
+
+1. **Describe your idea** — "build a market maker for bitcoin"
+2. **AI researches** — checks real spreads, volume, liquidity
+3. **AI proposes code** — complete Python with hz.run()
+4. **Code panel opens** — shows the code with syntax highlighting
+5. **Iterate** — "make the spread tighter", "add a stop loss"
+6. **Backtest** — "backtest it" runs real hz.backtest()
+7. **Run locally** — "run it" executes in paper mode sandbox
+8. **Deploy** — "deploy it" pushes to Horizon cloud
+
+## Code Panel (Ctrl+G)
+
+Three tabs:
+- **Code** — strategy source with Python highlighting
+- **Logs** — stdout/stderr from run_strategy
+- **Dashboard** — HTML source from spawn_dashboard
+
+Switch tabs with Ctrl+1, Ctrl+2, Ctrl+3.
+
+## Tools
+
+Strategy code is generated by writing \`\`\`python code fences.
+Code streams into the panel in real-time as the AI writes it.
+
+| Tool | Purpose |
+|------|---------|
+| edit_strategy | Find-and-replace for small changes |
+| validate_strategy | Check against SDK sandbox rules |
+| backtest_strategy | Run hz.backtest() with real metrics |
+| run_strategy | Execute locally in paper mode |
+| read_logs | Check process output |
+| save_strategy | Push to Horizon platform |
+| lookup_sdk_docs | Fetch advanced SDK docs |
+| polymarket_data | Search real markets |
+| run_command | Shell commands (pip install, etc.) |
+| spawn_dashboard | Serve custom HTML dashboard |
+
+## The Code
+
+Strategies are single Python files using the Horizon SDK:
+
+\`\`\`python
+import horizon as hz
+
+def fair_value(ctx):
+    feed = ctx.feeds.get("mid")
+    if not feed or feed.is_stale(30):
+        return None
+    return feed.price
+
+def quoter(ctx, fair):
+    if fair is None:
+        return []
+    return hz.quotes(fair, spread=0.06, size=5)
+
+hz.run(
+    name="MyStrategy",
+    exchange=hz.Polymarket(),
+    markets=["market-slug"],
+    feeds={"mid": hz.PolymarketBook("market-slug")},
+    pipeline=[fair_value, quoter],
+    risk=hz.Risk(max_position=100),
+    mode="paper",
+)
+\`\`\`
+
+## File Persistence
+
+Strategies auto-save to ~/.horizon/strategies/ on every change.
+Use \`/strategies\` to list, \`/load <name>\` to load.
+`,
+
+  portfolio: `# Portfolio Mode
+
+Monitor and manage your live deployments.
+
+## Bots Panel (Ctrl+D)
+
+Shows all your strategies with status:
+- Running strategies show a spinner
+- Stopped strategies show a dash
+- Error strategies show an x
+
+Navigate with arrow keys, Enter to expand details.
+
+## Actions
+
+When a strategy is expanded:
+- **r** — restart a stopped strategy (redeploys with same settings)
+- **p** — pause a running strategy
+- **k** — kill a running strategy
+
+## Metrics
+
+When metrics are available for running strategies:
+
+| Metric | Meaning |
+|--------|---------|
+| Total P&L | Net profit/loss |
+| Realized P&L | Closed position profits |
+| Unrealized P&L | Open position mark-to-market |
+| Win Rate | Percentage of profitable trades |
+| Max Drawdown | Largest peak-to-trough decline |
+| Sharpe Ratio | Risk-adjusted return (>1 is good, >2 is great) |
+| Sortino Ratio | Like Sharpe but only penalizes downside |
+| Profit Factor | Gross profit / gross loss (>1.5 is good) |
+| Expectancy | Average profit per trade |
+
+## AI Tools
+
+In portfolio mode, the AI has these tools:
+- **list_strategies** — see all strategies
+- **get_strategy** — full detail with code
+- **list_deployments** — deployment history
+- **get_metrics** — live P&L, positions, orders
+- **get_logs** — recent bot output
+- **deploy_strategy** — deploy to paper or live
+- **stop_strategy** — stop a deployment
+`,
+
+  settings: `# Settings & Configuration
+
+Open with **/settings**. Navigate with arrow keys, left/right to change.
+
+---
+
+## Intelligence
+
+Controls which AI model powers your chat:
+
+| Level | Model | Budget multiplier |
+|-------|-------|-------------------|
+| **Fast** | Hunter Alpha | 0.25x (cheapest) |
+| **Standard** | Claude Haiku 4.5 | 1x |
+| **Pro** | Claude Sonnet 4.6 | 2x (Pro plan+) |
+| **Ultra** | Claude Opus 4.6 | 4x (Ultra plan only) |
+
+Higher intelligence = smarter responses but drains your token
+budget faster. Fast is great for simple queries.
+
+---
+
+## Response Style
+
+- **Short** — 1-2 sentences max. Terse, no elaboration.
+- **Normal** — balanced (default)
+- **Verbose** — detailed explanations with reasoning
+
+Does NOT affect code generation in strategy mode.
+
+---
+
+## Hooks
+
+Open with **/hooks**. Custom bash commands that run at strategy
+lifecycle points. Each hook shows output in chat.
+
+| Event | When it runs |
+|-------|-------------|
+| before_generate | Before AI writes strategy code |
+| after_generate | After code is proposed |
+| before_validate | Before validation check |
+| before_backtest | Before running backtest |
+| before_deploy | Before deploying to cloud |
+| after_deploy | After deploy succeeds |
+
+**Adding a hook:** press \`a\`, select event, type command, enter.
+**Example:** \`before_deploy\` -> \`ruff check strategy.py\`
+
+---
+
+## Encrypted API Keys
+
+Store keys for SDK integrations (Alpaca, Unusual Whales, etc.):
+
+\`/env add ALPACA_KEY sk-your-key-here\`
+\`/env list\` — see stored keys
+\`/env remove ALPACA_KEY\` — delete a key
+
+Keys are encrypted with **AES-256-GCM** using a key derived from
+your Horizon API key. Stored in ~/.horizon/config.json.
+
+---
+
+## Safety Controls
+
+**Pay As You Go** — off by default. When on, allows extra charges
+if your token budget runs out. When off, hard stop.
+
+**Live Trading** — off by default. Must be enabled to deploy live
+strategies. Paper mode only until you turn this on.
+
+---
+
+## Themes
+
+Four themes: **Dark** (default), **Midnight**, **Nord**, **Solarized**.
+Restart to fully apply.
+
+---
+
+## Other Settings
+
+- **Auto Focus** — focus input after sending a message
+- **Smart Compact** — auto-compact context when it gets full
+- **Compact Warning** — threshold % to warn about context usage
+- **Show Tool Calls** — show/hide tool call indicators in chat
+- **Sound** — terminal bell on generation complete
+`,
+
+  commands: `# Commands
+
+Type \`/\` to see autocomplete suggestions as you type.
+
+---
+
+## Chat
+
+| Command | Action |
+|---------|--------|
+| /clear | Clear current chat messages |
+| /compact | Force context compaction |
+| /context | Show context window usage |
+
+## Auth
+
+| Command | Action |
+|---------|--------|
+| /login | Browser auth (Google) |
+| /login email pass | Email/password login |
+| /logout | Sign out |
+| /whoami | Show current user |
+
+## Panels
+
+| Command | Action |
+|---------|--------|
+| /settings | Open settings panel |
+| /hooks | Manage lifecycle hooks |
+| /tutorial | This guide |
+| /code | Toggle code panel |
+| /home | Back to splash screen |
+
+## Mode
+
+| Command | Action |
+|---------|--------|
+| /mode | Cycle research/strategy/portfolio |
+| /mode research | Switch to research |
+| /mode strategy | Switch to strategy |
+| /usage | Toggle metrics display |
+| /privacy | Toggle privacy mode |
+
+## Strategy
+
+| Command | Action |
+|---------|--------|
+| /strategies | List saved strategies on disk |
+| /load name | Load a saved strategy |
+
+## Environment
+
+| Command | Action |
+|---------|--------|
+| /env list | Show stored encrypted keys |
+| /env add NAME VALUE | Store an encrypted API key |
+| /env remove NAME | Delete a stored key |
+| /tutorial | This guide |
+
+## Context
+
+| Command | Action |
+|---------|--------|
+| /compact | Force context compaction |
+| /context | Show context window usage |
+
+## System
+
+| Command | Action |
+|---------|--------|
+| /help | List all commands |
+| /quit | Exit Horizon |
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| Ctrl+R | Cycle mode |
+| Ctrl+E | Toggle sessions panel |
+| Ctrl+D | Toggle bots panel |
+| Ctrl+G | Toggle code panel |
+| Ctrl+T | Toggle metrics display |
+| Ctrl+P | Toggle privacy mode |
+| Ctrl+1/2/3 | Code panel tabs |
+| Esc | Stop generation / close panel |
+| PageUp/Down | Scroll chat |
+`,
+
+  tips: `# Tips
+
+---
+
+## Research
+
+- **Be specific** — *"order book for btc-100k"* beats *"show me bitcoin"*
+- **Chain requests** — *"analyze the first one"* reuses the slug
+- **EV before betting** — calculates Kelly sizing from your edge
+- **Cross-platform** — *"compare bitcoin Polymarket vs Kalshi"* for arb
+
+---
+
+## Strategy
+
+- **Let it research first** — the AI checks real spreads before coding
+- **Paper mode default** — always starts safe. Enable Live in /settings
+- **Backtest before deploy** — real \`hz.backtest()\` metrics
+- **Small edits** — the AI uses find/replace for tweaks, full rewrite for rewrites
+- **Ctrl+G** — code panel shows validation status (green = valid)
+
+---
+
+## Performance
+
+- **Ctrl+T** — toggle metrics bar (context %, budget, tokens)
+- **Smart compact** — enabled by default, prompts before compacting
+- **/compact** — force compaction when context is high
+- **Queue messages** — send while generating, they process in order
+- **Esc** — interrupt generation. Queue pauses with /resume
+
+---
+
+## Security
+
+- **Sandboxed execution** — strategy code runs in temp dirs, no secrets
+- **Server-side enforcement** — budget, rate limits, model access checked server-side
+- **Encrypted env vars** — \`/env add\` stores keys with AES-256-GCM
+- **Paper mode guard** — /settings → Live Trading must be ON for live deploys
+- **Config permissions** — ~/.horizon/config.json is 0600 (owner only)
+`,
+};
+
+export class TutorialPanel {
+  readonly container: BoxRenderable;
+  private tabBar: BoxRenderable;
+  private tabTexts: Map<TutorialTab, TextRenderable> = new Map();
+  private contentScroll: ScrollBoxRenderable;
+  private contentMd: MarkdownRenderable;
+  private _visible = false;
+  private _activeTab: TutorialTab = "start";
+
+  constructor(private renderer: CliRenderer) {
+    this.container = new BoxRenderable(renderer, {
+      id: "tutorial-panel",
+      width: "50%",
+      height: "100%",
+      flexDirection: "column",
+      borderColor: COLORS.borderDim,
+    });
+    this.container.visible = false;
+
+    // Tab bar
+    this.tabBar = new BoxRenderable(renderer, {
+      id: "tutorial-tabs",
+      height: 1,
+      width: "100%",
+      flexDirection: "row",
+      alignItems: "center",
+      paddingLeft: 1,
+      paddingRight: 1,
+      backgroundColor: COLORS.bgDarker,
+      flexShrink: 0,
+    });
+
+    for (const tab of TAB_LIST) {
+      const text = new TextRenderable(renderer, {
+        id: `tutorial-tab-${tab.id}`,
+        content: ` ${tab.label} `,
+        fg: COLORS.textMuted,
+      });
+      this.tabTexts.set(tab.id, text);
+      this.tabBar.add(text);
+    }
+    this.container.add(this.tabBar);
+
+    // Content area
+    this.contentScroll = new ScrollBoxRenderable(renderer, {
+      id: "tutorial-scroll",
+      flexGrow: 1,
+      paddingLeft: 2,
+      paddingRight: 2,
+      paddingTop: 1,
+      stickyScroll: false,
+    });
+    this.contentMd = new MarkdownRenderable(renderer, {
+      id: "tutorial-md",
+      content: CONTENT.start,
+      syntaxStyle,
+    });
+    this.contentScroll.add(this.contentMd);
+    this.container.add(this.contentScroll);
+
+    // Footer
+    this.container.add(new TextRenderable(renderer, {
+      id: "tutorial-footer",
+      content: " < > switch tab  |  /tutorial to close",
+      fg: COLORS.borderDim,
+    }));
+
+    this.updateTabBar();
+  }
+
+  get visible(): boolean { return this._visible; }
+
+  show(): void {
+    this._visible = true;
+    this.container.visible = true;
+    this.renderer.requestRender();
+  }
+
+  hide(): void {
+    this._visible = false;
+    this.container.visible = false;
+    this.renderer.requestRender();
+  }
+
+  toggle(): void {
+    if (this._visible) this.hide();
+    else this.show();
+  }
+
+  setTab(tab: TutorialTab): void {
+    this._activeTab = tab;
+    this.contentMd.content = CONTENT[tab];
+    this.updateTabBar();
+    this.renderer.requestRender();
+  }
+
+  nextTab(): void {
+    const idx = TAB_LIST.findIndex((t) => t.id === this._activeTab);
+    this.setTab(TAB_LIST[(idx + 1) % TAB_LIST.length]!.id);
+  }
+
+  prevTab(): void {
+    const idx = TAB_LIST.findIndex((t) => t.id === this._activeTab);
+    this.setTab(TAB_LIST[(idx - 1 + TAB_LIST.length) % TAB_LIST.length]!.id);
+  }
+
+  private updateTabBar(): void {
+    for (const [id, text] of this.tabTexts) {
+      if (id === this._activeTab) {
+        text.fg = "#212121";
+        text.bg = COLORS.secondary;
+        text.content = ` ${TAB_LIST.find((t) => t.id === id)!.label} `;
+      } else {
+        text.fg = COLORS.textMuted;
+        text.bg = undefined;
+        text.content = ` ${TAB_LIST.find((t) => t.id === id)!.label} `;
+      }
+    }
+  }
+}

package/src/components/widgets/progress-bar.ts

@@ -0,0 +1,38 @@
+import { TextRenderable, type CliRenderer } from "@opentui/core";
+import { COLORS } from "../../theme/colors.ts";
+import { ICONS } from "../../theme/icons.ts";
+
+export class ProgressBar {
+  private text: TextRenderable;
+
+  constructor(
+    renderer: CliRenderer,
+    id: string,
+    private width: number = 20,
+  ) {
+    this.text = new TextRenderable(renderer, {
+      id,
+      content: "",
+      fg: COLORS.textMuted,
+    });
+  }
+
+  get renderable(): TextRenderable {
+    return this.text;
+  }
+
+  setValue(pct: number, label?: string): void {
+    const clamped = Math.max(0, Math.min(100, pct));
+    const filled = Math.round((clamped / 100) * this.width);
+    const empty = this.width - filled;
+
+    const bar = ICONS.barFull.repeat(filled) + ICONS.barEmpty.repeat(empty);
+    const suffix = label ?? `${clamped.toFixed(0)}%`;
+
+    this.text.content = `${bar} ${suffix}`;
+
+    if (clamped <= 60) this.text.fg = COLORS.success;
+    else if (clamped <= 80) this.text.fg = COLORS.warning;
+    else this.text.fg = COLORS.error;
+  }
+}