@bloomai/cli 0.1.2 → 0.1.4

package/README.md

@@ -46,12 +46,25 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
 | `screen` | Filter stocks by metrics | `bloom screen "market_cap > 100B" "pe_ratio < 25"` |
 | `earnings` | Earnings history & estimates | `bloom earnings AAPL` |
 | `technicals` | RSI, MAs, patterns, options flow | `bloom technicals AAPL` |
+| `ma` | Raw moving average data (SMA/EMA) | `bloom ma AAPL --sma 50,100,200 --ema 20` |
 | `options-history` | Options sentiment over time | `bloom options-history AAPL --days 30` |
 | `portfolio` | Portfolio risk analysis | `bloom portfolio '{"AAPL":0.5,"MSFT":0.5}'` |
 | `trades` | AI trade evaluation | `bloom trades "Buy AAPL: strong AI catalysts"` |
 | `catalysts` | Forward-looking value drivers | `bloom catalysts AAPL MSFT` |
 | `position-size` | Kelly criterion sizing | `bloom position-size --bull 0.6 --bear -0.15 --conviction 8 --value 100000` |
 | `transcript` | Search earnings call transcripts | `bloom transcript AAPL "AI" "services"` |
+| `ai-trades` | Recent AI model trade decisions (InvestingArena) | `bloom ai-trades --model claude --limit 5` |
+| `ai-portfolio` | AI model portfolio positions & performance | `bloom ai-portfolio --model openai` |
+| `search` | Web search via Serper (Google) | `bloom search "nvidia earnings Q1 2026"` |
+| `scrape` | Scrape a web page via Firecrawl | `bloom scrape https://example.com` |
+
+## Environment Variables
+
+| Variable | Required for | Description |
+|----------|-------------|-------------|
+| `BLOOM_API_KEY` | All financial commands | Bloom API key (`bloom auth login`) |
+| `SERPER_API_KEY` | `bloom search` | Serper.dev API key for web search |
+| `FIRECRAWL_API_KEY` | `bloom scrape` | Firecrawl API key for web scraping |
 
 ## Global Flags
 
@@ -115,6 +128,57 @@ bloom transcript AAPL "AI" "services" "margins" --max 20 -o /tmp/bloom/transcrip
 jq '.matches[] | {speaker, text}' /tmp/bloom/transcript.json
 ```
 
+### Moving Averages
+```bash
+# Default: 100-day SMA + 100-day EMA
+bloom ma AAPL
+
+# Custom periods
+bloom ma AAPL --sma 50,100,200 --ema 20,100
+
+# Last 50 data points, save to file
+bloom ma AAPL --sma 200 --limit 50 -o /tmp/bloom/aapl-ma.json
+
+# Extract latest values
+jq '.indicators | to_entries[] | {(.key): .value | to_entries | last | .value}' /tmp/bloom/aapl-ma.json
+```
+
+### AI Arena (InvestingArena — 3 AIs with real money)
+```bash
+# All AI models' recent trades
+bloom ai-trades -o /tmp/bloom/ai-trades.json
+
+# Claude's last 5 trades
+bloom ai-trades --model claude --limit 5
+
+# All trades on NVDA across all models
+bloom ai-trades --symbol NVDA -o /tmp/bloom/nvda-ai-trades.json
+
+# Full portfolio snapshot for all 3 models
+bloom ai-portfolio -o /tmp/bloom/ai-portfolio.json
+
+# Just Gemini's portfolio
+bloom ai-portfolio --model gemini
+
+# Extract model returns
+jq '[.[] | {model: .ai_model, return_pct, account_value}]' /tmp/bloom/ai-portfolio.json
+```
+
+### Web Research (Search + Scrape)
+```bash
+# Search the web
+bloom search "nvidia earnings Q1 2026" --limit 5 -o /tmp/bloom/search.json
+
+# Search for news specifically
+bloom search "AAPL product launch" --type news --limit 10
+
+# Scrape a page for full content
+bloom scrape https://example.com/article -o /tmp/bloom/article.md
+
+# Truncate long pages
+bloom scrape https://example.com/article --max-chars 5000
+```
+
 ## Tips
 
 - Use `-o` to download data to files, then `jq` to extract. Saves context tokens.

package/SKILL.md

@@ -48,6 +48,18 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
 | `catalysts` | Forward-looking value drivers | `bloom catalysts AAPL MSFT` |
 | `position-size` | Kelly criterion sizing | `bloom position-size --bull 0.6 --bear -0.15 --conviction 8 --value 100000` |
 | `transcript` | Search earnings call transcripts | `bloom transcript AAPL "AI" "services"` |
+| `ai-trades` | Recent AI model trade decisions (InvestingArena) | `bloom ai-trades --model claude --limit 5` |
+| `ai-portfolio` | AI model portfolio positions & performance | `bloom ai-portfolio --model openai` |
+| `search` | Web search via Serper (Google) | `bloom search "nvidia earnings Q1 2026"` |
+| `scrape` | Scrape a web page via Firecrawl | `bloom scrape https://example.com` |
+
+## Environment Variables
+
+| Variable | Required for | Description |
+|----------|-------------|-------------|
+| `BLOOM_API_KEY` | All financial commands | Bloom API key (`bloom auth login`) |
+| `SERPER_API_KEY` | `bloom search` | Serper.dev API key for web search |
+| `FIRECRAWL_API_KEY` | `bloom scrape` | Firecrawl API key for web scraping |
 
 ## Global Flags
 
@@ -111,6 +123,27 @@ bloom transcript AAPL "AI" "services" "margins" --max 20 -o /tmp/bloom/transcrip
 jq '.matches[] | {speaker, text}' /tmp/bloom/transcript.json
 ```
 
+### AI Arena (InvestingArena — 3 AIs with real money)
+```bash
+# All AI models' recent trades
+bloom ai-trades -o /tmp/bloom/ai-trades.json
+
+# Claude's last 5 trades
+bloom ai-trades --model claude --limit 5
+
+# All trades on NVDA across all models
+bloom ai-trades --symbol NVDA -o /tmp/bloom/nvda-ai-trades.json
+
+# Full portfolio snapshot for all 3 models
+bloom ai-portfolio -o /tmp/bloom/ai-portfolio.json
+
+# Just Gemini's portfolio
+bloom ai-portfolio --model gemini
+
+# Extract model returns
+jq '[.[] | {model: .ai_model, return_pct, account_value}]' /tmp/bloom/ai-portfolio.json
+```
+
 ## Tips
 
 - Use `-o` to download data to files, then `jq` to extract. Saves context tokens.

package/dist/index.js

@@ -452,7 +452,9 @@ var CHART_TYPES = [
   "net_earnings",
   "net_earnings_growth",
   "free_cash_flow",
-  "free_cash_flow_growth"
+  "free_cash_flow_growth",
+  "stock_based_compensation",
+  "stock_based_compensation_growth"
 ];
 function registerFinancialsCommand(program2) {
   addGlobalOptions(
@@ -511,12 +513,13 @@ function formatSentiment(data) {
 // src/commands/market.ts
 function registerMarketCommand(program2) {
   addGlobalOptions(
-    program2.command("market").description("Market performance, sectors, global").option("--type <type>", "top_movers|sector_breakdown|global_markets|major_indexes", "top_movers").option("--period <p>", "1d|1w|1m|3m|6m|ytd|1y|5y", "1d").option("--limit <n>", "Max stocks for top_movers", "24")
+    program2.command("market").description("Market performance, sectors, global").option("--type <type>", "top_movers|sector_breakdown|global_markets|major_indexes", "top_movers").option("--period <p>", "1d|1w|1m|3m|6m|ytd|1y|5y", "1d").option("--limit <n>", "Max stocks for top_movers", "24").option("--universe <u>", "all|sp500|international|crypto|community", "all")
   ).action(async (opts) => {
     const data = await callTool("get_market_map", {
       map_type: opts.type,
       period: opts.period,
-      limit: parseIntSafe(opts.limit, 24)
+      limit: parseIntSafe(opts.limit, 24),
+      universe: opts.universe
     });
     outputResult(data, opts);
   });
@@ -782,12 +785,350 @@ function formatTranscript(data, opts) {
   return makeTable(["Speaker", "Role", "Text"], rows, opts);
 }
 
+// src/commands/ai-trades.ts
+function registerAiTradesCommand(program2) {
+  addGlobalOptions(
+    program2.command("ai-trades").description("Recent trade decisions from AI models competing with real money (InvestingArena)").option("--model <m>", "Filter by AI model: claude|openai|gemini").option("--symbol <s>", "Filter by stock ticker symbol (e.g., AAPL)").option("--limit <n>", "Max recent trades per model (default: 10, max: 50)", "10")
+  ).action(async (opts) => {
+    const args = {
+      limit: parseIntSafe(opts.limit, 10)
+    };
+    if (opts.model) args.ai_model = opts.model;
+    if (opts.symbol) args.symbol = opts.symbol.toUpperCase();
+    const data = await callTool("get_ai_trade_ideas", args);
+    if (opts.raw) {
+      outputResult(data, opts);
+      return;
+    }
+    const obj = data;
+    const trades = obj.recent_trades ?? data;
+    outputResult(trades, opts, (d, o) => formatTrades(d, o));
+  });
+}
+function formatTrades(data, opts) {
+  if (!data || !Array.isArray(data)) {
+    if (data && typeof data === "object") {
+      return JSON.stringify(data, null, 2);
+    }
+    return String(data ?? "(no trades)");
+  }
+  if (data.length === 0) return "(no trades found)";
+  const rows = data.map((trade) => {
+    const t = trade;
+    const gain = t.realized_gain_loss != null ? `$${Number(t.realized_gain_loss).toFixed(2)}` : "-";
+    return [
+      String(t.ai_model ?? t.model ?? "-"),
+      String(t.action ?? "-").toUpperCase(),
+      String(t.symbol ?? "-"),
+      String(t.shares ?? "-"),
+      t.fill_price != null ? `$${Number(t.fill_price).toFixed(2)}` : "-",
+      gain,
+      truncate2(String(t.rationale ?? "-"), 60)
+    ];
+  });
+  return makeTable(
+    ["Model", "Action", "Symbol", "Shares", "Fill Price", "Realized P/L", "Rationale"],
+    rows,
+    opts
+  );
+}
+function truncate2(s, max) {
+  return s.length > max ? s.slice(0, max - 1) + "\u2026" : s;
+}
+
+// src/commands/ai-portfolio.ts
+function registerAiPortfolioCommand(program2) {
+  addGlobalOptions(
+    program2.command("ai-portfolio").description("Current portfolio positions held by AI models (InvestingArena live accounts)").option("--model <m>", "Filter by AI model: claude|openai|gemini")
+  ).action(async (opts) => {
+    const args = {};
+    if (opts.model) args.ai_model = opts.model;
+    const data = await callTool("get_ai_trade_ideas", args);
+    if (opts.raw) {
+      outputResult(data, opts);
+      return;
+    }
+    const obj = data;
+    const portfolios = obj.portfolios ?? data;
+    outputResult(portfolios, opts, (d, o) => formatPortfolios(d, o));
+  });
+}
+function formatPortfolios(data, opts) {
+  if (!data || !Array.isArray(data)) {
+    if (data && typeof data === "object") {
+      return JSON.stringify(data, null, 2);
+    }
+    return String(data ?? "(no portfolio data)");
+  }
+  if (data.length === 0) return "(no portfolio data found)";
+  const lines = [];
+  for (const portfolio of data) {
+    const p = portfolio;
+    const modelName = String(p.ai_model ?? p.model ?? "Unknown").toUpperCase();
+    lines.push(`
+=== ${modelName} ===`);
+    const acctValue = p.account_value != null ? `$${Number(p.account_value).toFixed(2)}` : "-";
+    const cash = p.cash != null ? `$${Number(p.cash).toFixed(2)}` : "-";
+    const returnPct = p.return_pct != null ? `${Number(p.return_pct).toFixed(2)}%` : "-";
+    const pnl = p.total_pnl != null ? `$${Number(p.total_pnl).toFixed(2)}` : "-";
+    lines.push(`  Account Value: ${acctValue}  |  Cash: ${cash}  |  Return: ${returnPct}  |  Total P&L: ${pnl}`);
+    const positions = p.positions;
+    if (Array.isArray(positions) && positions.length > 0) {
+      lines.push("");
+      const rows = positions.map((pos) => {
+        const position = pos;
+        const unrealizedPnl = position.unrealized_pnl != null ? `$${Number(position.unrealized_pnl).toFixed(2)}` : "-";
+        const allocation = position.allocation_pct != null ? `${Number(position.allocation_pct).toFixed(1)}%` : "-";
+        const avgCost = position.avg_cost != null ? `$${Number(position.avg_cost).toFixed(2)}` : "-";
+        return [
+          String(position.symbol ?? "-"),
+          String(position.qty ?? "-"),
+          avgCost,
+          unrealizedPnl,
+          allocation
+        ];
+      });
+      lines.push(
+        makeTable(["Symbol", "Qty", "Avg Cost", "Unrealized P/L", "Allocation"], rows, opts)
+      );
+    } else {
+      lines.push("  (no open positions)");
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/commands/ma.ts
+function formatTable(data, limit) {
+  const { symbol, current_price, indicators } = data;
+  const labels = Object.keys(indicators);
+  if (labels.length === 0) {
+    console.log(`No indicator data returned for ${symbol}`);
+    return;
+  }
+  const allDates = /* @__PURE__ */ new Set();
+  for (const label of labels) {
+    const ind = indicators[label];
+    if ("error" in ind) continue;
+    for (const date of Object.keys(ind)) {
+      allDates.add(date);
+    }
+  }
+  const sortedDates = Array.from(allDates).sort((a, b) => b.localeCompare(a)).slice(0, limit).reverse();
+  if (sortedDates.length === 0) {
+    console.log(`No data points available for ${symbol}`);
+    return;
+  }
+  const dateWidth = 12;
+  const colWidth = 12;
+  const header = "Date".padEnd(dateWidth) + labels.map((l) => l.toUpperCase().padStart(colWidth)).join("");
+  const divider = "-".repeat(dateWidth + colWidth * labels.length);
+  console.log(`
+${symbol}${current_price != null ? `  (current: $${current_price.toFixed(2)})` : ""}`);
+  console.log(divider);
+  console.log(header);
+  console.log(divider);
+  for (const date of sortedDates) {
+    let row = date.padEnd(dateWidth);
+    for (const label of labels) {
+      const ind = indicators[label];
+      if ("error" in ind) {
+        row += "N/A".padStart(colWidth);
+      } else {
+        const val = ind[date];
+        row += (val != null ? val.toFixed(2) : "\u2014").padStart(colWidth);
+      }
+    }
+    console.log(row);
+  }
+  console.log(divider);
+  console.log(`Showing ${sortedDates.length} data point(s)
+`);
+}
+function registerMaCommand(program2) {
+  addGlobalOptions(
+    program2.command("ma").description("Moving averages (SMA/EMA) for a symbol").argument("<symbol>", "Ticker symbol (e.g., AAPL)").option("--sma <periods>", "Comma-separated SMA periods (e.g., 50,100,200)").option("--ema <periods>", "Comma-separated EMA periods (e.g., 20,50)").option("--limit <n>", "Number of data points to display (default: 20)", "20")
+  ).action(
+    async (symbol, opts) => {
+      const indicators = [];
+      if (opts.sma) {
+        for (const p of opts.sma.split(",")) {
+          const period = p.trim();
+          if (period) indicators.push(`sma_${period}`);
+        }
+      }
+      if (opts.ema) {
+        for (const p of opts.ema.split(",")) {
+          const period = p.trim();
+          if (period) indicators.push(`ema_${period}`);
+        }
+      }
+      if (indicators.length === 0) {
+        indicators.push("sma_100", "ema_100");
+      }
+      const args = {
+        symbol: symbol.toUpperCase(),
+        indicators
+      };
+      const data = await callTool("get_moving_averages", args);
+      const limit = parseInt(opts.limit, 10) || 20;
+      let parsed = null;
+      try {
+        parsed = typeof data === "string" ? JSON.parse(data) : data;
+      } catch {
+      }
+      if (parsed?.indicators && typeof parsed.indicators === "object") {
+        const allDates = /* @__PURE__ */ new Set();
+        for (const ind of Object.values(parsed.indicators)) {
+          if ("error" in ind) continue;
+          for (const date of Object.keys(ind)) {
+            allDates.add(date);
+          }
+        }
+        const keepDates = new Set(
+          Array.from(allDates).sort((a, b) => b.localeCompare(a)).slice(0, limit)
+        );
+        for (const [label, ind] of Object.entries(parsed.indicators)) {
+          if ("error" in ind) continue;
+          const filtered = {};
+          for (const [date, val] of Object.entries(ind)) {
+            if (keepDates.has(date)) filtered[date] = val;
+          }
+          parsed.indicators[label] = filtered;
+        }
+      }
+      if (opts.output || opts.format || opts.raw || !process.stdout.isTTY) {
+        outputResult(parsed ?? data, opts);
+        return;
+      }
+      if (parsed?.indicators && typeof parsed.indicators === "object") {
+        formatTable(parsed, limit);
+      } else {
+        outputResult(data, opts);
+      }
+    }
+  );
+}
+
+// src/commands/search.ts
+function registerSearchCommand(program2) {
+  addGlobalOptions(
+    program2.command("search").description("Web search via Serper (Google)").argument("<query...>", "Search query (joined into one string)").option("--limit <n>", "Max results (default: 10)", "10").option("--type <type>", "Search type: web, news, images (default: web)", "web")
+  ).action(async (query, opts) => {
+    const apiKey = process.env.SERPER_API_KEY;
+    if (!apiKey) {
+      console.error("Error: SERPER_API_KEY environment variable is required.");
+      process.exit(1);
+    }
+    const q = query.join(" ");
+    const limit = parseIntSafe(opts.limit, 10);
+    const searchType = opts.type || "web";
+    const validTypes = /* @__PURE__ */ new Set(["web", "news", "images"]);
+    if (!validTypes.has(searchType)) {
+      console.error(`Error: Invalid search type "${searchType}". Must be one of: web, news, images`);
+      process.exit(1);
+    }
+    const endpoint = searchType === "web" ? "search" : searchType;
+    const response = await fetch(`https://google.serper.dev/${endpoint}`, {
+      method: "POST",
+      headers: {
+        "X-API-KEY": apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ q, num: limit })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      console.error(`Serper API error (${response.status}): ${text}`);
+      process.exit(1);
+    }
+    const data = await response.json();
+    outputResult(data, opts, (d, o) => formatSearch(d, o));
+  });
+}
+function formatSearch(data, opts) {
+  if (!data || typeof data !== "object") return String(data);
+  const obj = data;
+  const organic = obj.organic || obj.news || obj.images || [];
+  if (!Array.isArray(organic) || organic.length === 0) return "(no results)";
+  const rows = organic.map((r) => [
+    String(r.position ?? ""),
+    String(r.title || "").slice(0, 60),
+    String(r.link || "").slice(0, 60),
+    String(r.snippet || r.description || "").slice(0, 80)
+  ]);
+  return makeTable(["#", "Title", "URL", "Snippet"], rows, opts);
+}
+
+// src/commands/scrape.ts
+function registerScrapeCommand(program2) {
+  addGlobalOptions(
+    program2.command("scrape").description("Scrape a web page via Firecrawl").argument("<url>", "URL to scrape").option("--max-chars <n>", "Truncate output to N characters")
+  ).action(async (url, opts) => {
+    if (opts.maxChars !== void 0 && isNaN(parseInt(opts.maxChars, 10))) {
+      console.error("Error: --max-chars must be a number");
+      process.exit(1);
+    }
+    const apiKey = process.env.FIRECRAWL_API_KEY;
+    if (!apiKey) {
+      console.error("Error: FIRECRAWL_API_KEY environment variable is required.");
+      process.exit(1);
+    }
+    const response = await fetch("https://api.firecrawl.dev/v1/scrape", {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ url, formats: ["markdown"] })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      console.error(`Firecrawl API error (${response.status}): ${text}`);
+      process.exit(1);
+    }
+    const data = await response.json();
+    outputResult(data, opts, (d, o) => formatScrape(d, o, opts.maxChars));
+  });
+}
+function formatScrape(data, _opts, maxChars) {
+  if (!data || typeof data !== "object") return String(data);
+  const obj = data;
+  const inner = obj.data || obj;
+  const content = String(inner.markdown || inner.text || inner.content || "(no content)");
+  const title = inner.metadata ? String(inner.metadata.title || "") : "";
+  const header = title ? `# ${title}
+
+` : "";
+  const body = header + content;
+  if (maxChars) {
+    const limit = parseIntSafe(maxChars, body.length);
+    if (body.length > limit) {
+      return body.slice(0, limit) + "\n\n... (truncated)";
+    }
+  }
+  return body;
+}
+
 // src/index.ts
 var program = new Command();
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
 var pkgPath = path.join(__dirname, "..", "package.json");
-var pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
-program.name("bloom").description("Bloom CLI \u2014 financial data for coding agents and humans").version(pkg.version);
+var compiledVersion = "0.1.4".length > 0 ? "0.1.4" : void 0;
+var envVersion = process.env.BLOOM_CLI_VERSION ?? process.env.npm_package_version;
+var fallbackVersion = compiledVersion ?? "unknown";
+var cliVersion = envVersion ?? fallbackVersion;
+try {
+  const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
+  if (typeof pkg.version === "string") {
+    cliVersion = pkg.version;
+  }
+} catch {
+}
+if (cliVersion === "0.0.0") {
+  cliVersion = fallbackVersion;
+}
+program.name("bloom").description("Bloom CLI \u2014 financial data for coding agents and humans").version(cliVersion);
 registerAuthCommand(program);
 registerInfoCommand(program);
 registerNewsCommand(program);
@@ -805,6 +1146,11 @@ registerTradesCommand(program);
 registerCatalystsCommand(program);
 registerPositionCommand(program);
 registerTranscriptCommand(program);
+registerAiTradesCommand(program);
+registerAiPortfolioCommand(program);
+registerMaCommand(program);
+registerSearchCommand(program);
+registerScrapeCommand(program);
 program.parseAsync().catch((err) => {
   console.error("Error:", err.message || err);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloomai/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI tool for Bloom financial data - download market data to files for analysis",
   "type": "module",
   "bin": {