@blockrun/llm 1.7.0 → 1.8.1

package/README.md

@@ -103,7 +103,7 @@ const client = new LLMClient();
 // Auto-routes to cheapest capable model
 const result = await client.smartChat('What is 2+2?');
 console.log(result.response);     // '4'
-console.log(result.model);        // 'nvidia/kimi-k2.5' (cheap, fast)
+console.log(result.model);        // 'moonshot/kimi-k2.5' (cheap, fast)
 console.log(`Saved ${(result.routing.savings * 100).toFixed(0)}%`); // 'Saved 78%'
 
 // Complex reasoning task -> routes to reasoning model
@@ -144,7 +144,7 @@ The classifier runs in <1ms, 100% locally, and routes to one of four tiers:
 
 | Tier | Example Tasks | Auto Profile Model |
 |------|---------------|-------------------|
-| SIMPLE | "What is 2+2?", definitions | nvidia/kimi-k2.5 |
+| SIMPLE | "What is 2+2?", definitions | moonshot/kimi-k2.5 |
 | MEDIUM | Code snippets, explanations | xai/grok-code-fast-1 |
 | COMPLEX | Architecture, long documents | google/gemini-3.1-pro |
 | REASONING | Proofs, multi-step reasoning | xai/grok-4-1-fast-reasoning |
@@ -227,6 +227,7 @@ The classifier runs in <1ms, 100% locally, and routes to one of four tiers:
 ### Moonshot Kimi
 | Model | Input Price | Output Price |
 |-------|-------------|--------------|
+| `moonshot/kimi-k2.6` | $0.95/M | $4.00/M |
 | `moonshot/kimi-k2.5` | $0.60/M | $3.00/M |
 
 ### MiniMax
@@ -235,11 +236,23 @@ The classifier runs in <1ms, 100% locally, and routes to one of four tiers:
 | `minimax/minimax-m2.7` | $0.30/M | $1.20/M |
 | `minimax/minimax-m2.5` | $0.30/M | $1.20/M |
 
-### NVIDIA (Free & Hosted)
+### NVIDIA (Free) + Moonshot
+
+Free tier refreshed 2026-04-21: retired the Nemotron family, `mistral-large-3-675b`,
+`devstral-2-123b`, and paid `nvidia/kimi-k2.5`. The backend auto-redirects the
+old IDs; the recommended replacements are listed below.
+
 | Model | Input Price | Output Price | Notes |
 |-------|-------------|--------------|-------|
-| `nvidia/gpt-oss-120b` | **FREE** | **FREE** | OpenAI open-weight 120B (Apache 2.0) |
-| `nvidia/kimi-k2.5` | $0.60/M | $3.00/M | Moonshot 1T MoE with vision |
+| `nvidia/qwen3-next-80b-a3b-thinking` | **FREE** | **FREE** | Reasoning flagship — 116 tok/s, thinking mode |
+| `nvidia/mistral-small-4-119b` | **FREE** | **FREE** | Fastest free chat — 114 tok/s |
+| `nvidia/glm-4.7` | **FREE** | **FREE** | GLM-4.7 with thinking — 237 tok/s |
+| `nvidia/llama-4-maverick` | **FREE** | **FREE** | Llama 4 Maverick MoE |
+| `nvidia/qwen3-coder-480b` | **FREE** | **FREE** | Coding-optimised 480B MoE |
+| `nvidia/deepseek-v3.2` | **FREE** | **FREE** | DeepSeek V3.2 hosted |
+| `nvidia/gpt-oss-120b` | **FREE** | **FREE** | OpenAI open-weight 120B — 123 tok/s |
+| `nvidia/gpt-oss-20b` | **FREE** | **FREE** | OpenAI open-weight 20B — 155 tok/s |
+| `moonshot/kimi-k2.5` | $0.60/M | $3.00/M | Direct from Moonshot — replaces `nvidia/kimi-k2.5` |
 
 ### E2E Verified Models
 
@@ -254,7 +267,7 @@ All models below have been tested end-to-end via the TypeScript SDK (Feb 2026):
 | Google | `google/gemini-2.5-flash` | Passed |
 | DeepSeek | `deepseek/deepseek-chat` | Passed |
 | xAI | `xai/grok-3` | Passed |
-| Moonshot | `moonshot/kimi-k2.5` | Passed |
+| Moonshot | `moonshot/kimi-k2.6` | Passed |
 
 ### Image Generation
 | Model | Price |
@@ -287,6 +300,70 @@ const r2 = await client.generate('the subject turns and smiles', {
 });
 ```
 
+### Standalone Search
+
+`SearchClient` wraps `POST /v1/search` — standalone Grok Live Search.
+Pricing: `$0.025/source + margin` (10 sources ≈ `$0.26`).
+
+```ts
+import { SearchClient } from '@blockrun/llm';
+
+const client = new SearchClient();
+const result = await client.search('Latest news on x402 adoption', {
+  sources: ['x', 'web'],
+  maxResults: 10,
+});
+console.log(result.summary);
+for (const url of result.citations ?? []) console.log(url);
+```
+
+### X/Twitter (AttentionVC)
+
+`XClient` covers the full `/v1/x/*` endpoint family — previously the `X*`
+types were exported but there was no client to call them with.
+
+```ts
+import { XClient } from '@blockrun/llm';
+
+const x = new XClient();
+const info = await x.userInfo('elonmusk');
+const followers = await x.followers('paulg');
+const results = await x.search('x402 micropayments', { queryType: 'Latest' });
+const tweets = await x.userTweets({ username: 'vitalikbuterin', includeReplies: false });
+```
+
+Methods: `userLookup`, `userInfo`, `followers`, `following`, `followings`,
+`verifiedFollowers`, `userTweets`, `mentions`, `tweetLookup`, `tweetReplies`,
+`tweetThread`, `search`, `trending`, `articlesRising`.
+
+### Market Data (Pyth)
+
+`PriceClient` wraps the Pyth-backed market-data endpoints. Crypto, FX and
+commodity are fully free (price + history + list); 12 global stock markets
+and the `usstock` legacy alias charge `$0.001` for price + history (list is
+always free). Pass `requireWallet: false` to construct a free-only client.
+
+```ts
+import { PriceClient } from '@blockrun/llm';
+
+const p = new PriceClient({ requireWallet: false });
+const btc = await p.price('crypto', 'BTC-USD');
+const eur = await p.price('fx', 'EUR-USD');
+
+// Paid — requires a wallet
+const p2 = new PriceClient();
+const aapl = await p2.price('stocks', 'AAPL', { market: 'us' });
+const bars = await p2.history('stocks', 'AAPL', {
+  market: 'us',
+  resolution: 'D',
+  from: 1700000000,
+  to: 1710000000,
+});
+const symbols = await p.listSymbols('crypto', { query: 'sol', limit: 20 });
+```
+
+Supported `StockMarket` values: `us, hk, jp, kr, gb, de, fr, nl, ie, lu, cn, ca`.
+
 ### Testnet Models (Base Sepolia)
 | Model | Price |
 |-------|-------|