@blockrun/llm 3.23.1 → 3.24.0

package/README.md

@@ -444,10 +444,13 @@ picked:
 **Search and routing.** xAI search (`x_search` / `web_search` tools, or
 `search` / `searchParameters` not set to `mode: 'off'`) runs on `xai/*` models
 only. When a routed call asks for search, the candidate chain is narrowed to
-its `xai/*` models in the router's order; when the route has none, `route()` /
-`smartChat()` / `smartChatCompletion()` throw before anything is sent or paid.
-For search, calling an `xai/*` model directly (e.g. `xai/grok-4.3`) is the
-dependable path.
+its `xai/*` models in the router's order. The router seldom ranks xAI, so when
+the route has none, the call falls back to the catalog's search-capable xAI
+models (those `/v1/models` tags `search`): cheapest first on `eco` / `auto`,
+most capable first on `premium`. `routing.reasoning` says when that happened.
+Only a catalog with no `xai/*` chat model at all makes `route()` /
+`smartChat()` / `smartChatCompletion()` throw, before anything is sent or paid.
+Pin an `xai/*` model yourself when you want a specific one.
 
 ### TypeScript Types
 
@@ -1600,9 +1603,9 @@ await status();
 
 `getOrCreateWallet()` resolves the Base wallet in a fixed order:
 `BLOCKRUN_WALLET_KEY` or `BASE_CHAIN_WALLET_KEY`, then `~/.blockrun/.session`,
-then the legacy `~/.blockrun/wallet.key`. `LLMClient` itself reads only
-`BASE_CHAIN_WALLET_KEY` (or an explicit `privateKey`). For a single run of the
-helpers without changing anything, use `export BLOCKRUN_WALLET_KEY=<private-key>`.
+then the legacy `~/.blockrun/wallet.key`. `LLMClient` reads an explicit
+`privateKey`, then `BASE_CHAIN_WALLET_KEY`, then `BLOCKRUN_WALLET_KEY`. For a
+single run without changing anything, use `export BLOCKRUN_WALLET_KEY=<private-key>`.
 
 ### Wallet discovery and migration
 
@@ -1686,7 +1689,7 @@ const configured = new LLMClient({
 | `BLOCKRUN_API_KEY` | Account key (`brk_...`): account billing, no wallet needed. Create one at [user.blockrun.ai/dashboard/keys](https://user.blockrun.ai/dashboard/keys) |
 | `BLOCKRUN_API_BASE_URL` | Account API endpoint (default `https://api.blockrun.ai`) |
 | `BASE_CHAIN_WALLET_KEY` | EVM wallet private key for `LLMClient` (Base / Arc) and every EVM client |
-| `BLOCKRUN_WALLET_KEY` | EVM wallet key honoured by the service clients, `BlockrunClient`, `setupAgentWallet()` and `AnthropicClient` (checked before `BASE_CHAIN_WALLET_KEY`); **not** read by `LLMClient` |
+| `BLOCKRUN_WALLET_KEY` | EVM wallet key read by every EVM client. The service clients, `BlockrunClient`, `setupAgentWallet()` and `AnthropicClient` check it before `BASE_CHAIN_WALLET_KEY`; `LLMClient` checks it after, so a process holding both keeps paying from the same wallet |
 | `SOLANA_WALLET_KEY` | Solana secret key, bs58-encoded, for `SolanaLLMClient` |
 | `SOLANA_RPC_URL` | Solana RPC for payments and balance (also `rpcUrl`) |
 | `SOLANA_RPC_API_KEY` / `SOLANA_RPC_HEADERS` | Header auth for that RPC (also `rpcHeaders`) |

package/dist/index.cjs

@@ -4359,6 +4359,24 @@ function requestsSearch(options) {
   if (options.searchParameters !== void 0) return options.searchParameters.mode !== "off";
   return options.search === true;
 }
+var searchModelsByCatalog = /* @__PURE__ */ new WeakMap();
+function registerSearchModels(pricing, models) {
+  const xaiChat = models.filter(
+    (m) => m.id.startsWith("xai/") && m.available !== false && Array.isArray(m.categories) && m.categories.includes("chat") && pricing.has(m.id)
+  );
+  const tagged = xaiChat.filter((m) => m.categories.includes("search"));
+  searchModelsByCatalog.set(pricing, (tagged.length > 0 ? tagged : xaiChat).map((m) => m.id));
+}
+function searchFallbackChain(modelPricing, routingProfile) {
+  const pool = searchModelsByCatalog.get(modelPricing) ?? [...modelPricing.keys()].filter((id) => id.startsWith("xai/"));
+  const price = (id) => {
+    const p = modelPricing.get(id);
+    return p ? p.inputPrice + p.outputPrice : Number.POSITIVE_INFINITY;
+  };
+  const sorted = [...pool].sort((a, b) => price(a) - price(b) || b.localeCompare(a, void 0, { numeric: true }));
+  if (routingProfile !== "premium") return sorted;
+  return [...pool].sort((a, b) => price(b) - price(a) || b.localeCompare(a, void 0, { numeric: true }));
+}
 function routingProfileForModel(model) {
   return AUTO_ROUTING_PROFILES[model.toLowerCase()];
 }
@@ -4406,11 +4424,16 @@ function routeWithCatalog(prompt, systemPrompt, maxOutputTokens, modelPricing, o
     const resolved = !id.startsWith("free/") ? id : modelPricing.has(`nvidia/${id.slice(5)}`) ? `nvidia/${id.slice(5)}` : null;
     if (resolved && !callable.includes(resolved)) callable.push(resolved);
   }
+  let searchFallback = false;
   if (requestsSearch(options)) {
-    const searchable = callable.filter((id) => id.startsWith("xai/"));
+    let searchable = callable.filter((id) => id.startsWith("xai/"));
+    if (searchable.length === 0) {
+      searchable = searchFallbackChain(modelPricing, options.routingProfile);
+      searchFallback = true;
+    }
     if (searchable.length === 0) {
       throw new Error(
-        `Search (x_search / web_search tools or searchParameters) runs on xai/* models only, and the ${options.routingProfile ?? "auto"} route has no xai/* candidate for this request. Call an xai/* model directly (e.g. xai/grok-4.3) or drop the search options.`
+        `Search (x_search / web_search tools or searchParameters) runs on xai/* models only, and the catalog lists no available xai/* chat model. Call an xai/* model directly or drop the search options.`
       );
     }
     callable.splice(0, callable.length, ...searchable);
@@ -4447,7 +4470,7 @@ function routeWithCatalog(prompt, systemPrompt, maxOutputTokens, modelPricing, o
     costEstimate,
     savings,
     model,
-    reasoning: model === decision.model ? decision.reasoning : `${decision.reasoning} | catalog fallback: ${model}`,
+    reasoning: searchFallback ? `${decision.reasoning} | search runs on xai/* only; the route had none, so the ${options.routingProfile === "premium" ? "most capable" : "cheapest"} search-capable xAI model: ${model}` : model === decision.model ? decision.reasoning : `${decision.reasoning} | catalog fallback: ${model}`,
     candidates: availableCandidates,
     candidateScores: decision.candidateScores?.filter(
       (score) => availableCandidates.includes(score.model)
@@ -4833,7 +4856,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.23.1";
+var SDK_VERSION = "3.24.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -4908,16 +4931,16 @@ var LLMClient = class _LLMClient {
   /**
    * Initialize the BlockRun LLM client.
    *
-   * @param options - Client configuration options (optional if BASE_CHAIN_WALLET_KEY env var is set)
+   * @param options - Client configuration options (optional if BLOCKRUN_API_KEY, BASE_CHAIN_WALLET_KEY or BLOCKRUN_WALLET_KEY is set)
    */
   constructor(options = {}) {
     this.apiAuth = resolveApiKeyAuth(options);
     if (!this.apiAuth) {
-      const envKey = typeof process !== "undefined" && process.env ? process.env.BASE_CHAIN_WALLET_KEY : void 0;
+      const envKey = typeof process !== "undefined" && process.env ? process.env.BASE_CHAIN_WALLET_KEY || process.env.BLOCKRUN_WALLET_KEY : void 0;
       const privateKey = options.privateKey || envKey;
       if (!privateKey) {
         throw new Error(
-          "Private key required. Pass privateKey in options or set BASE_CHAIN_WALLET_KEY environment variable."
+          "Private key required. Pass privateKey in options or set BASE_CHAIN_WALLET_KEY (or BLOCKRUN_WALLET_KEY) environment variable."
         );
       }
       validatePrivateKey(privateKey);
@@ -5104,6 +5127,7 @@ var LLMClient = class _LLMClient {
         pricing.set(model.id, { inputPrice, outputPrice });
       }
     }
+    registerSearchModels(pricing, models);
     return pricing;
   }
   /**
@@ -5606,7 +5630,7 @@ var LLMClient = class _LLMClient {
   }
   /**
    * Make a request with automatic x402 payment handling, returning raw JSON.
-   * Used for non-ChatResponse endpoints (X/Twitter, search, image edit, etc.).
+   * Used for non-ChatResponse endpoints (search, image edit, etc.).
    */
   async requestWithPaymentRaw(endpoint, body) {
     const url = `${this.apiUrl}${endpoint}`;
@@ -6014,7 +6038,8 @@ var LLMClient = class _LLMClient {
     return data;
   }
   /**
-   * Standalone search (web, X/Twitter, news).
+   * Standalone search over web and news. For X/Twitter, use chat on an
+   * `xai/*` model with an `x_search` tool.
    *
    * @param query - Search query
    * @param options - Optional search parameters
@@ -8508,6 +8533,7 @@ var import_accounts12 = require("viem/accounts");
 var DEFAULT_API_URL11 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT11 = 6e4;
 var SURF_PREFIX = "/v1/surf";
+var warnedRetired = false;
 var SurfClient = class {
   _account;
   get account() {
@@ -8525,6 +8551,12 @@ var SurfClient = class {
   apiUrl;
   timeout;
   constructor(options = {}) {
+    if (!warnedRetired) {
+      warnedRetired = true;
+      console.warn(
+        "[blockrun] SurfClient is deprecated: the gateway retired /v1/surf/* (410 endpoint_retired). Use PriceClient, LLMClient.defi*, LLMClient.pm() or LLMClient.dex* instead."
+      );
+    }
     this.apiAuth = resolveApiKeyAuth(options);
     if (!this.apiAuth) {
       const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
@@ -12559,6 +12591,7 @@ var SolanaLLMClient = class {
           ...(model.billingMode ?? raw.billing_mode) === "flat" && flatPrice > 0 ? { flatPrice } : {}
         });
       }
+      registerSearchModels(pricing, models);
       return pricing;
     })();
     try {

package/dist/index.d.cts

@@ -499,7 +499,7 @@ interface PaymentRequired {
     extensions?: Record<string, unknown>;
 }
 interface LLMClientOptions extends ApiKeyOptions {
-    /** EVM wallet private key (hex string starting with 0x). Optional if BASE_CHAIN_WALLET_KEY env var is set. */
+    /** EVM wallet private key (hex string starting with 0x). Optional if BASE_CHAIN_WALLET_KEY (or BLOCKRUN_WALLET_KEY) is set. */
     privateKey?: `0x${string}` | string;
     /** API endpoint URL (default: https://blockrun.ai/api) */
     apiUrl?: string;
@@ -975,7 +975,10 @@ interface VideoGenerateOptions {
     returnLastFrame?: boolean;
 }
 interface SearchOptions {
-    /** Source types to search (e.g. ["web", "x", "news"]) */
+    /**
+     * Source types to search: `"web"` and/or `"news"` (default `["web"]`). `"x"` is
+     * rejected by the gateway; X search runs in chat on `xai/*` models (`x_search`).
+     */
     sources?: string[];
     /** Maximum number of results (default: 10) */
     maxResults?: number;
@@ -1119,6 +1122,7 @@ interface PriceClientOptions extends ApiKeyOptions {
     /** If false, construction succeeds without a wallet (free endpoints only). */
     requireWallet?: boolean;
 }
+/** @deprecated Surf is retired; see {@link SurfClient}. */
 interface SurfClientOptions extends ApiKeyOptions {
     privateKey?: `0x${string}` | string;
     apiUrl?: string;
@@ -1351,7 +1355,7 @@ declare class LLMClient {
     /**
      * Initialize the BlockRun LLM client.
      *
-     * @param options - Client configuration options (optional if BASE_CHAIN_WALLET_KEY env var is set)
+     * @param options - Client configuration options (optional if BLOCKRUN_API_KEY, BASE_CHAIN_WALLET_KEY or BLOCKRUN_WALLET_KEY is set)
      */
     constructor(options?: LLMClientOptions);
     /**
@@ -1510,7 +1514,7 @@ declare class LLMClient {
     chatCompletionStream(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<Response>;
     /**
      * Make a request with automatic x402 payment handling, returning raw JSON.
-     * Used for non-ChatResponse endpoints (X/Twitter, search, image edit, etc.).
+     * Used for non-ChatResponse endpoints (search, image edit, etc.).
      */
     private requestWithPaymentRaw;
     /**
@@ -1574,7 +1578,8 @@ declare class LLMClient {
      */
     imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /**
-     * Standalone search (web, X/Twitter, news).
+     * Standalone search over web and news. For X/Twitter, use chat on an
+     * `xai/*` model with an `x_search` tool.
      *
      * @param query - Search query
      * @param options - Optional search parameters
@@ -2328,6 +2333,7 @@ declare class PriceClient {
 
 type QueryValue$1 = string | number | boolean | null | undefined;
 type QueryParams$1 = Record<string, QueryValue$1 | QueryValue$1[]>;
+/** @deprecated Surf is retired (`410 endpoint_retired`); see the module docs for replacements. */
 declare class SurfClient {
     private _account?;
     private get account();
@@ -2947,8 +2953,9 @@ interface SolanaBatchOptions {
      * re-read, in addition to the one-line log the SDK writes to stderr for each.
      * A callback that throws, or returns a promise that rejects, is logged and
      * ignored; it never affects the payment, and its promise is not awaited.
+     * Any other return value is ignored, so `(e) => events.push(e)` is fine.
      */
-    onEvent?: (event: SolanaBatchEvent) => void | PromiseLike<void>;
+    onEvent?: (event: SolanaBatchEvent) => unknown;
 }
 /** Default {@link SolanaBatchOptions.rateLimit}. */
 declare const DEFAULT_BATCH_RATE_LIMIT: {

package/dist/index.d.ts

@@ -499,7 +499,7 @@ interface PaymentRequired {
     extensions?: Record<string, unknown>;
 }
 interface LLMClientOptions extends ApiKeyOptions {
-    /** EVM wallet private key (hex string starting with 0x). Optional if BASE_CHAIN_WALLET_KEY env var is set. */
+    /** EVM wallet private key (hex string starting with 0x). Optional if BASE_CHAIN_WALLET_KEY (or BLOCKRUN_WALLET_KEY) is set. */
     privateKey?: `0x${string}` | string;
     /** API endpoint URL (default: https://blockrun.ai/api) */
     apiUrl?: string;
@@ -975,7 +975,10 @@ interface VideoGenerateOptions {
     returnLastFrame?: boolean;
 }
 interface SearchOptions {
-    /** Source types to search (e.g. ["web", "x", "news"]) */
+    /**
+     * Source types to search: `"web"` and/or `"news"` (default `["web"]`). `"x"` is
+     * rejected by the gateway; X search runs in chat on `xai/*` models (`x_search`).
+     */
     sources?: string[];
     /** Maximum number of results (default: 10) */
     maxResults?: number;
@@ -1119,6 +1122,7 @@ interface PriceClientOptions extends ApiKeyOptions {
     /** If false, construction succeeds without a wallet (free endpoints only). */
     requireWallet?: boolean;
 }
+/** @deprecated Surf is retired; see {@link SurfClient}. */
 interface SurfClientOptions extends ApiKeyOptions {
     privateKey?: `0x${string}` | string;
     apiUrl?: string;
@@ -1351,7 +1355,7 @@ declare class LLMClient {
     /**
      * Initialize the BlockRun LLM client.
      *
-     * @param options - Client configuration options (optional if BASE_CHAIN_WALLET_KEY env var is set)
+     * @param options - Client configuration options (optional if BLOCKRUN_API_KEY, BASE_CHAIN_WALLET_KEY or BLOCKRUN_WALLET_KEY is set)
      */
     constructor(options?: LLMClientOptions);
     /**
@@ -1510,7 +1514,7 @@ declare class LLMClient {
     chatCompletionStream(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<Response>;
     /**
      * Make a request with automatic x402 payment handling, returning raw JSON.
-     * Used for non-ChatResponse endpoints (X/Twitter, search, image edit, etc.).
+     * Used for non-ChatResponse endpoints (search, image edit, etc.).
      */
     private requestWithPaymentRaw;
     /**
@@ -1574,7 +1578,8 @@ declare class LLMClient {
      */
     imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /**
-     * Standalone search (web, X/Twitter, news).
+     * Standalone search over web and news. For X/Twitter, use chat on an
+     * `xai/*` model with an `x_search` tool.
      *
      * @param query - Search query
      * @param options - Optional search parameters
@@ -2328,6 +2333,7 @@ declare class PriceClient {
 
 type QueryValue$1 = string | number | boolean | null | undefined;
 type QueryParams$1 = Record<string, QueryValue$1 | QueryValue$1[]>;
+/** @deprecated Surf is retired (`410 endpoint_retired`); see the module docs for replacements. */
 declare class SurfClient {
     private _account?;
     private get account();
@@ -2947,8 +2953,9 @@ interface SolanaBatchOptions {
      * re-read, in addition to the one-line log the SDK writes to stderr for each.
      * A callback that throws, or returns a promise that rejects, is logged and
      * ignored; it never affects the payment, and its promise is not awaited.
+     * Any other return value is ignored, so `(e) => events.push(e)` is fine.
      */
-    onEvent?: (event: SolanaBatchEvent) => void | PromiseLike<void>;
+    onEvent?: (event: SolanaBatchEvent) => unknown;
 }
 /** Default {@link SolanaBatchOptions.rateLimit}. */
 declare const DEFAULT_BATCH_RATE_LIMIT: {

package/dist/index.js

@@ -4228,6 +4228,24 @@ function requestsSearch(options) {
   if (options.searchParameters !== void 0) return options.searchParameters.mode !== "off";
   return options.search === true;
 }
+var searchModelsByCatalog = /* @__PURE__ */ new WeakMap();
+function registerSearchModels(pricing, models) {
+  const xaiChat = models.filter(
+    (m) => m.id.startsWith("xai/") && m.available !== false && Array.isArray(m.categories) && m.categories.includes("chat") && pricing.has(m.id)
+  );
+  const tagged = xaiChat.filter((m) => m.categories.includes("search"));
+  searchModelsByCatalog.set(pricing, (tagged.length > 0 ? tagged : xaiChat).map((m) => m.id));
+}
+function searchFallbackChain(modelPricing, routingProfile) {
+  const pool = searchModelsByCatalog.get(modelPricing) ?? [...modelPricing.keys()].filter((id) => id.startsWith("xai/"));
+  const price = (id) => {
+    const p = modelPricing.get(id);
+    return p ? p.inputPrice + p.outputPrice : Number.POSITIVE_INFINITY;
+  };
+  const sorted = [...pool].sort((a, b) => price(a) - price(b) || b.localeCompare(a, void 0, { numeric: true }));
+  if (routingProfile !== "premium") return sorted;
+  return [...pool].sort((a, b) => price(b) - price(a) || b.localeCompare(a, void 0, { numeric: true }));
+}
 function routingProfileForModel(model) {
   return AUTO_ROUTING_PROFILES[model.toLowerCase()];
 }
@@ -4275,11 +4293,16 @@ function routeWithCatalog(prompt, systemPrompt, maxOutputTokens, modelPricing, o
     const resolved = !id.startsWith("free/") ? id : modelPricing.has(`nvidia/${id.slice(5)}`) ? `nvidia/${id.slice(5)}` : null;
     if (resolved && !callable.includes(resolved)) callable.push(resolved);
   }
+  let searchFallback = false;
   if (requestsSearch(options)) {
-    const searchable = callable.filter((id) => id.startsWith("xai/"));
+    let searchable = callable.filter((id) => id.startsWith("xai/"));
+    if (searchable.length === 0) {
+      searchable = searchFallbackChain(modelPricing, options.routingProfile);
+      searchFallback = true;
+    }
     if (searchable.length === 0) {
       throw new Error(
-        `Search (x_search / web_search tools or searchParameters) runs on xai/* models only, and the ${options.routingProfile ?? "auto"} route has no xai/* candidate for this request. Call an xai/* model directly (e.g. xai/grok-4.3) or drop the search options.`
+        `Search (x_search / web_search tools or searchParameters) runs on xai/* models only, and the catalog lists no available xai/* chat model. Call an xai/* model directly or drop the search options.`
       );
     }
     callable.splice(0, callable.length, ...searchable);
@@ -4316,7 +4339,7 @@ function routeWithCatalog(prompt, systemPrompt, maxOutputTokens, modelPricing, o
     costEstimate,
     savings,
     model,
-    reasoning: model === decision.model ? decision.reasoning : `${decision.reasoning} | catalog fallback: ${model}`,
+    reasoning: searchFallback ? `${decision.reasoning} | search runs on xai/* only; the route had none, so the ${options.routingProfile === "premium" ? "most capable" : "cheapest"} search-capable xAI model: ${model}` : model === decision.model ? decision.reasoning : `${decision.reasoning} | catalog fallback: ${model}`,
     candidates: availableCandidates,
     candidateScores: decision.candidateScores?.filter(
       (score) => availableCandidates.includes(score.model)
@@ -4702,7 +4725,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.23.1";
+var SDK_VERSION = "3.24.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -4777,16 +4800,16 @@ var LLMClient = class _LLMClient {
   /**
    * Initialize the BlockRun LLM client.
    *
-   * @param options - Client configuration options (optional if BASE_CHAIN_WALLET_KEY env var is set)
+   * @param options - Client configuration options (optional if BLOCKRUN_API_KEY, BASE_CHAIN_WALLET_KEY or BLOCKRUN_WALLET_KEY is set)
    */
   constructor(options = {}) {
     this.apiAuth = resolveApiKeyAuth(options);
     if (!this.apiAuth) {
-      const envKey = typeof process !== "undefined" && process.env ? process.env.BASE_CHAIN_WALLET_KEY : void 0;
+      const envKey = typeof process !== "undefined" && process.env ? process.env.BASE_CHAIN_WALLET_KEY || process.env.BLOCKRUN_WALLET_KEY : void 0;
       const privateKey = options.privateKey || envKey;
       if (!privateKey) {
         throw new Error(
-          "Private key required. Pass privateKey in options or set BASE_CHAIN_WALLET_KEY environment variable."
+          "Private key required. Pass privateKey in options or set BASE_CHAIN_WALLET_KEY (or BLOCKRUN_WALLET_KEY) environment variable."
         );
       }
       validatePrivateKey(privateKey);
@@ -4973,6 +4996,7 @@ var LLMClient = class _LLMClient {
         pricing.set(model.id, { inputPrice, outputPrice });
       }
     }
+    registerSearchModels(pricing, models);
     return pricing;
   }
   /**
@@ -5475,7 +5499,7 @@ var LLMClient = class _LLMClient {
   }
   /**
    * Make a request with automatic x402 payment handling, returning raw JSON.
-   * Used for non-ChatResponse endpoints (X/Twitter, search, image edit, etc.).
+   * Used for non-ChatResponse endpoints (search, image edit, etc.).
    */
   async requestWithPaymentRaw(endpoint, body) {
     const url = `${this.apiUrl}${endpoint}`;
@@ -5883,7 +5907,8 @@ var LLMClient = class _LLMClient {
     return data;
   }
   /**
-   * Standalone search (web, X/Twitter, news).
+   * Standalone search over web and news. For X/Twitter, use chat on an
+   * `xai/*` model with an `x_search` tool.
    *
    * @param query - Search query
    * @param options - Optional search parameters
@@ -8377,6 +8402,7 @@ import { privateKeyToAccount as privateKeyToAccount11 } from "viem/accounts";
 var DEFAULT_API_URL11 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT11 = 6e4;
 var SURF_PREFIX = "/v1/surf";
+var warnedRetired = false;
 var SurfClient = class {
   _account;
   get account() {
@@ -8394,6 +8420,12 @@ var SurfClient = class {
   apiUrl;
   timeout;
   constructor(options = {}) {
+    if (!warnedRetired) {
+      warnedRetired = true;
+      console.warn(
+        "[blockrun] SurfClient is deprecated: the gateway retired /v1/surf/* (410 endpoint_retired). Use PriceClient, LLMClient.defi*, LLMClient.pm() or LLMClient.dex* instead."
+      );
+    }
     this.apiAuth = resolveApiKeyAuth(options);
     if (!this.apiAuth) {
       const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
@@ -12428,6 +12460,7 @@ var SolanaLLMClient = class {
           ...(model.billingMode ?? raw.billing_mode) === "flat" && flatPrice > 0 ? { flatPrice } : {}
         });
       }
+      registerSearchModels(pricing, models);
       return pricing;
     })();
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "3.23.1",
+  "version": "3.24.0",
   "type": "module",
   "description": "TypeScript SDK for BlockRun - every frontier model behind one OpenAI-compatible client. Pay with a BlockRun API key or per-call in USDC. Smart routing picks the cheapest capable model. No rate limits.",
   "main": "dist/index.cjs",