@blockrun/llm 3.11.0 → 3.13.0

package/dist/index.d.cts

@@ -252,6 +252,8 @@ interface ChatResponse {
         model?: string;
         settlementSkipped?: boolean;
     };
+    /** Present when a `blockrun/auto|eco|premium` alias selected the model locally. */
+    routing?: RoutingDecision;
 }
 interface Model {
     id: string;
@@ -490,8 +492,8 @@ interface ChatCompletionOptions {
 type RoutingProfile = "eco" | "auto" | "premium";
 type RoutingTier = Tier;
 /**
- * Request classification produced by the portfolio router (ClawRouter
- * v0.12.242+, Router v3.4). Present on decisions with `method: "portfolio"`.
+ * Request classification produced by the bundled Router Core V3 portfolio
+ * router. Present on decisions with `method: "portfolio"`.
  */
 type RoutingTaskType = TaskType;
 /** Primary model + ordered fallbacks for one routing tier. */
@@ -500,7 +502,7 @@ interface RoutingDecision extends RoutingDecision$1 {
     /**
      * Remaining gateway-callable models, in the router's ranked order.
      * `chat()` walks this list when the primary model hits a transient error
-     * (timeout, network, 429, 5xx). Excludes the primary itself. ClawRouter's
+     * (timeout, network, 429, 5xx). Excludes the primary itself. The router's
      * proxy-namespace `free/*` ids appear here as their `nvidia/*` gateway
      * ids (or are dropped when the mapping is proxy-only).
      */
@@ -512,6 +514,12 @@ interface SmartChatOptions extends ChatOptions {
     /** Maximum output tokens (used for cost estimation) */
     maxOutputTokens?: number;
 }
+interface SmartChatCompletionOptions extends ChatCompletionOptions {
+    /** Routing profile: eco (budget), auto (balanced), premium (best quality) */
+    routingProfile?: RoutingProfile;
+    /** Maximum output tokens used for route cost/capacity estimation. */
+    maxOutputTokens?: number;
+}
 interface SmartChatResponse {
     /** The AI response text */
     response: string;
@@ -520,6 +528,14 @@ interface SmartChatResponse {
     /** Routing decision metadata */
     routing: RoutingDecision;
 }
+interface SmartChatCompletionResponse {
+    /** Full OpenAI-compatible response, including tool calls. */
+    response: ChatResponse;
+    /** Model selected before any transient runtime fallback. */
+    model: string;
+    /** Local routing decision and ordered fallback candidates. */
+    routing: RoutingDecision;
+}
 interface SearchResult {
     query: string;
     summary: string;
@@ -1192,11 +1208,17 @@ declare class LLMClient {
      * console.log(response); // 'The capital of France is Paris.'
      */
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    private makeRoutingDecision;
+    /**
+     * Inspect a local routing decision without making or paying for a model call.
+     * The first invocation may fetch the public model catalog for current prices.
+     */
+    route(prompt: string, options?: SmartChatOptions): Promise<RoutingDecision>;
     /**
      * Smart chat with automatic model routing.
      *
-     * Uses ClawRouter's deterministic portfolio router (Router v3.4, the Auto
-     * default since v0.12.242): it classifies the task shape locally (<1ms, no
+     * Uses BlockRun's product-neutral Router Core portfolio strategy: it
+     * classifies the task shape locally (no
      * extra model call), enforces capability constraints as hard filters, and
      * ranks an ordered candidate portfolio — the cheapest model that can handle
      * the request wins, and the rest become the transient-error fallback chain.
@@ -1224,21 +1246,14 @@ declare class LLMClient {
      * ```
      */
     smartChat(prompt: string, options?: SmartChatOptions): Promise<SmartChatResponse>;
+    /** Route a full Agent/tool conversation while preserving its complete response. */
+    smartChatCompletion(messages: ChatMessage[], options?: SmartChatCompletionOptions): Promise<SmartChatCompletionResponse>;
     /**
      * Get model pricing map (cached).
      * Fetches from API on first call, then returns cached result.
      */
     private getModelPricing;
-    /**
-     * Fetch model pricing from API.
-     *
-     * For flat-billed models (e.g. ZAI GLM-5 family at $0.001/call) the
-     * router still expects per-token rates, so we synthesise an equivalent
-     * per-token price assuming ~1500 total tokens per call. Without this,
-     * flat models would resolve to inputPrice=outputPrice=0 and the router
-     * would treat them as free, biasing routing decisions and reporting
-     * inflated savings %.
-     */
+    /** Fetch model pricing from the live catalog, preserving flat billing. */
     private fetchModelPricing;
     /**
      * Full chat completion interface (OpenAI-compatible).
@@ -2701,6 +2716,20 @@ declare function extractPaymentDetails(paymentRequired: PaymentRequired, preferr
  * - Auto-creates wallet if none exists
  * - Stores key securely at ~/.blockrun/.session
  * - Generates EIP-681 URIs for easy MetaMask funding
+ *
+ * Key resolution, discovery, and adoption are delegated to `@blockrun/core`, the
+ * shared kernel every BlockRun product reads. That is what guarantees this SDK,
+ * the `blockrun` CLI, and clawrouter-codex all resolve the SAME wallet — the
+ * behaviour is defined in one place instead of being re-implemented per product
+ * and drifting. Kept SDK-local: the funding/messaging surface (SDK-specific),
+ * plus createWallet()/saveWallet() as thin persistence wrappers for API
+ * compatibility — they write to the same core-resolved path, per call.
+ *
+ * Because path resolution now comes from core, `BLOCKRUN_HOME` overrides the base
+ * directory (previously this module always used the OS home directory). Treat
+ * that variable as security-sensitive: it redirects where the signing key is
+ * read from AND written to, so an environment that can set it controls the
+ * wallet as surely as one that can set BLOCKRUN_WALLET_KEY.
  */
 declare const USDC_BASE_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 interface WalletInfo {
@@ -2733,12 +2762,15 @@ declare function saveWallet(privateKey: string): string;
 /**
  * Discover ~/.<dir>/wallet.json files from other providers.
  *
- * Each file should contain JSON with "privateKey" and "address" fields.
- * Results are sorted by modification time (most recent first). Discovery is
- * intentionally opt-in: a provider wallet must never replace the canonical
- * BlockRun wallet merely because it was written more recently.
+ * Each file should contain JSON with a "privateKey" field; the returned
+ * address is DERIVED from that key (any "address" field in the file is
+ * ignored, so a file cannot claim an address it holds no key for), and
+ * entries whose key does not parse are dropped. Results are sorted by
+ * modification time (most recent first). Discovery is intentionally opt-in:
+ * a provider wallet must never replace the canonical BlockRun wallet merely
+ * because it was written more recently.
  *
- * @returns Array of wallet objects with privateKey and address
+ * @returns Array of wallet objects with privateKey and derived address
  */
 declare function scanWallets(): Array<{
     privateKey: string;
@@ -2771,6 +2803,12 @@ declare function listDiscoveredWallets(): Array<{
  * The current `~/.blockrun/.session` is backed up beside itself before being
  * overwritten, so adopting a wallet can't strand the funds in the old one.
  *
+ * NOTE: this is NOT `@blockrun/core`'s `importWallet(rawPrivateKey)` — that
+ * one persists a raw key and refuses to overwrite without `force`. This SDK
+ * function adopts a DISCOVERED wallet by address and maps onto core's
+ * `adoptWallet()`. Same name, different operation; don't mix them up when
+ * importing from core directly.
+ *
  * @param address Address to adopt, as shown by `listDiscoveredWallets()`
  * @returns The adopted address
  * @throws If no discovered wallet derives to that address
@@ -2908,6 +2946,8 @@ declare class SolanaLLMClient {
     private sessionTotalUsd;
     private sessionCalls;
     private addressCache;
+    private modelPricingCache;
+    private modelPricingPromise;
     constructor(options?: SolanaLLMClientOptions);
     /** Get Solana wallet address (public key in base58). */
     getWalletAddress(): Promise<string>;
@@ -2915,6 +2955,13 @@ declare class SolanaLLMClient {
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
     /** Full chat completion (OpenAI-compatible). */
     chatCompletion(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatResponse>;
+    private getModelPricing;
+    /** Inspect a Solana route without making or paying for a model call. */
+    route(prompt: string, options?: SmartChatOptions): Promise<RoutingDecision>;
+    /** Smart one-line chat paid on Solana. */
+    smartChat(prompt: string, options?: SmartChatOptions): Promise<SmartChatResponse>;
+    /** Smart full message/tool completion paid on Solana. */
+    smartChatCompletion(messages: ChatMessage[], options?: SmartChatCompletionOptions): Promise<SmartChatCompletionResponse>;
     /** List available models. */
     listModels(): Promise<Model[]>;
     /**
@@ -3257,6 +3304,8 @@ interface OpenAIChatCompletionResponse {
         completion_tokens: number;
         total_tokens: number;
     };
+    /** BlockRun extension present when a `blockrun/*` Auto alias was used. */
+    routing?: RoutingDecision;
 }
 interface OpenAIChatCompletionChunk {
     id: string;
@@ -3414,4 +3463,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatCompletionOptions, type SmartChatCompletionResponse, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };

package/dist/index.d.ts

@@ -252,6 +252,8 @@ interface ChatResponse {
         model?: string;
         settlementSkipped?: boolean;
     };
+    /** Present when a `blockrun/auto|eco|premium` alias selected the model locally. */
+    routing?: RoutingDecision;
 }
 interface Model {
     id: string;
@@ -490,8 +492,8 @@ interface ChatCompletionOptions {
 type RoutingProfile = "eco" | "auto" | "premium";
 type RoutingTier = Tier;
 /**
- * Request classification produced by the portfolio router (ClawRouter
- * v0.12.242+, Router v3.4). Present on decisions with `method: "portfolio"`.
+ * Request classification produced by the bundled Router Core V3 portfolio
+ * router. Present on decisions with `method: "portfolio"`.
  */
 type RoutingTaskType = TaskType;
 /** Primary model + ordered fallbacks for one routing tier. */
@@ -500,7 +502,7 @@ interface RoutingDecision extends RoutingDecision$1 {
     /**
      * Remaining gateway-callable models, in the router's ranked order.
      * `chat()` walks this list when the primary model hits a transient error
-     * (timeout, network, 429, 5xx). Excludes the primary itself. ClawRouter's
+     * (timeout, network, 429, 5xx). Excludes the primary itself. The router's
      * proxy-namespace `free/*` ids appear here as their `nvidia/*` gateway
      * ids (or are dropped when the mapping is proxy-only).
      */
@@ -512,6 +514,12 @@ interface SmartChatOptions extends ChatOptions {
     /** Maximum output tokens (used for cost estimation) */
     maxOutputTokens?: number;
 }
+interface SmartChatCompletionOptions extends ChatCompletionOptions {
+    /** Routing profile: eco (budget), auto (balanced), premium (best quality) */
+    routingProfile?: RoutingProfile;
+    /** Maximum output tokens used for route cost/capacity estimation. */
+    maxOutputTokens?: number;
+}
 interface SmartChatResponse {
     /** The AI response text */
     response: string;
@@ -520,6 +528,14 @@ interface SmartChatResponse {
     /** Routing decision metadata */
     routing: RoutingDecision;
 }
+interface SmartChatCompletionResponse {
+    /** Full OpenAI-compatible response, including tool calls. */
+    response: ChatResponse;
+    /** Model selected before any transient runtime fallback. */
+    model: string;
+    /** Local routing decision and ordered fallback candidates. */
+    routing: RoutingDecision;
+}
 interface SearchResult {
     query: string;
     summary: string;
@@ -1192,11 +1208,17 @@ declare class LLMClient {
      * console.log(response); // 'The capital of France is Paris.'
      */
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    private makeRoutingDecision;
+    /**
+     * Inspect a local routing decision without making or paying for a model call.
+     * The first invocation may fetch the public model catalog for current prices.
+     */
+    route(prompt: string, options?: SmartChatOptions): Promise<RoutingDecision>;
     /**
      * Smart chat with automatic model routing.
      *
-     * Uses ClawRouter's deterministic portfolio router (Router v3.4, the Auto
-     * default since v0.12.242): it classifies the task shape locally (<1ms, no
+     * Uses BlockRun's product-neutral Router Core portfolio strategy: it
+     * classifies the task shape locally (no
      * extra model call), enforces capability constraints as hard filters, and
      * ranks an ordered candidate portfolio — the cheapest model that can handle
      * the request wins, and the rest become the transient-error fallback chain.
@@ -1224,21 +1246,14 @@ declare class LLMClient {
      * ```
      */
     smartChat(prompt: string, options?: SmartChatOptions): Promise<SmartChatResponse>;
+    /** Route a full Agent/tool conversation while preserving its complete response. */
+    smartChatCompletion(messages: ChatMessage[], options?: SmartChatCompletionOptions): Promise<SmartChatCompletionResponse>;
     /**
      * Get model pricing map (cached).
      * Fetches from API on first call, then returns cached result.
      */
     private getModelPricing;
-    /**
-     * Fetch model pricing from API.
-     *
-     * For flat-billed models (e.g. ZAI GLM-5 family at $0.001/call) the
-     * router still expects per-token rates, so we synthesise an equivalent
-     * per-token price assuming ~1500 total tokens per call. Without this,
-     * flat models would resolve to inputPrice=outputPrice=0 and the router
-     * would treat them as free, biasing routing decisions and reporting
-     * inflated savings %.
-     */
+    /** Fetch model pricing from the live catalog, preserving flat billing. */
     private fetchModelPricing;
     /**
      * Full chat completion interface (OpenAI-compatible).
@@ -2701,6 +2716,20 @@ declare function extractPaymentDetails(paymentRequired: PaymentRequired, preferr
  * - Auto-creates wallet if none exists
  * - Stores key securely at ~/.blockrun/.session
  * - Generates EIP-681 URIs for easy MetaMask funding
+ *
+ * Key resolution, discovery, and adoption are delegated to `@blockrun/core`, the
+ * shared kernel every BlockRun product reads. That is what guarantees this SDK,
+ * the `blockrun` CLI, and clawrouter-codex all resolve the SAME wallet — the
+ * behaviour is defined in one place instead of being re-implemented per product
+ * and drifting. Kept SDK-local: the funding/messaging surface (SDK-specific),
+ * plus createWallet()/saveWallet() as thin persistence wrappers for API
+ * compatibility — they write to the same core-resolved path, per call.
+ *
+ * Because path resolution now comes from core, `BLOCKRUN_HOME` overrides the base
+ * directory (previously this module always used the OS home directory). Treat
+ * that variable as security-sensitive: it redirects where the signing key is
+ * read from AND written to, so an environment that can set it controls the
+ * wallet as surely as one that can set BLOCKRUN_WALLET_KEY.
  */
 declare const USDC_BASE_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 interface WalletInfo {
@@ -2733,12 +2762,15 @@ declare function saveWallet(privateKey: string): string;
 /**
  * Discover ~/.<dir>/wallet.json files from other providers.
  *
- * Each file should contain JSON with "privateKey" and "address" fields.
- * Results are sorted by modification time (most recent first). Discovery is
- * intentionally opt-in: a provider wallet must never replace the canonical
- * BlockRun wallet merely because it was written more recently.
+ * Each file should contain JSON with a "privateKey" field; the returned
+ * address is DERIVED from that key (any "address" field in the file is
+ * ignored, so a file cannot claim an address it holds no key for), and
+ * entries whose key does not parse are dropped. Results are sorted by
+ * modification time (most recent first). Discovery is intentionally opt-in:
+ * a provider wallet must never replace the canonical BlockRun wallet merely
+ * because it was written more recently.
  *
- * @returns Array of wallet objects with privateKey and address
+ * @returns Array of wallet objects with privateKey and derived address
  */
 declare function scanWallets(): Array<{
     privateKey: string;
@@ -2771,6 +2803,12 @@ declare function listDiscoveredWallets(): Array<{
  * The current `~/.blockrun/.session` is backed up beside itself before being
  * overwritten, so adopting a wallet can't strand the funds in the old one.
  *
+ * NOTE: this is NOT `@blockrun/core`'s `importWallet(rawPrivateKey)` — that
+ * one persists a raw key and refuses to overwrite without `force`. This SDK
+ * function adopts a DISCOVERED wallet by address and maps onto core's
+ * `adoptWallet()`. Same name, different operation; don't mix them up when
+ * importing from core directly.
+ *
  * @param address Address to adopt, as shown by `listDiscoveredWallets()`
  * @returns The adopted address
  * @throws If no discovered wallet derives to that address
@@ -2908,6 +2946,8 @@ declare class SolanaLLMClient {
     private sessionTotalUsd;
     private sessionCalls;
     private addressCache;
+    private modelPricingCache;
+    private modelPricingPromise;
     constructor(options?: SolanaLLMClientOptions);
     /** Get Solana wallet address (public key in base58). */
     getWalletAddress(): Promise<string>;
@@ -2915,6 +2955,13 @@ declare class SolanaLLMClient {
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
     /** Full chat completion (OpenAI-compatible). */
     chatCompletion(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatResponse>;
+    private getModelPricing;
+    /** Inspect a Solana route without making or paying for a model call. */
+    route(prompt: string, options?: SmartChatOptions): Promise<RoutingDecision>;
+    /** Smart one-line chat paid on Solana. */
+    smartChat(prompt: string, options?: SmartChatOptions): Promise<SmartChatResponse>;
+    /** Smart full message/tool completion paid on Solana. */
+    smartChatCompletion(messages: ChatMessage[], options?: SmartChatCompletionOptions): Promise<SmartChatCompletionResponse>;
     /** List available models. */
     listModels(): Promise<Model[]>;
     /**
@@ -3257,6 +3304,8 @@ interface OpenAIChatCompletionResponse {
         completion_tokens: number;
         total_tokens: number;
     };
+    /** BlockRun extension present when a `blockrun/*` Auto alias was used. */
+    routing?: RoutingDecision;
 }
 interface OpenAIChatCompletionChunk {
     id: string;
@@ -3414,4 +3463,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, AnthropicClient, type AudioModel, type AudioTrack, BASE_CHAIN_ID, type BarResolution, type BlockRunAnthropicOptions, BlockrunClient, type BlockrunClientOptions, BlockrunError, type CallInitiatedResponse, type CallModel, type CallOptions, type CallStatusResponse, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatResponseWithCost, type ChatUsage, type CostEntry, type CostEstimate, type CreatePaymentOptions, type FunctionCall, type FunctionDefinition, type HistoryOptions, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, type ImageGenerateOptions, type ImageModel, type ImageResponse, KNOWN_PROVIDERS, LLMClient, type LLMClientOptions, type ListOptions, type MarketSession, type Model, MusicClient, type MusicClientOptions, type MusicGenerateOptions, type MusicResponse, NETWORK_ALIASES, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PORTRAIT_ENROLLMENT_PRICE_USD, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, PortraitClient, type PortraitClientOptions, type PortraitEnrollOptions, type PortraitEnrollResponse, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, RPC_PRICE_USD, type ResponseFormat, RetiredEndpointError, type RoutingDecision, type RoutingProfile, type RoutingTaskType, type RoutingTier, type RoutingTierConfig, type RpcBatchRequest, RpcClient, type RpcClientOptions, type RpcError, type RpcNetwork, type RpcResponse, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SUPPORTED_NETWORKS, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatCompletionOptions, type SmartChatCompletionResponse, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type SoundEffectOptions, type SpeechAudio, SpeechClient, type SpeechClientOptions, type SpeechGenerateOptions, type SpeechModel, type SpeechResponse, type SpeechVoice, type Spending, type SpendingReport, type StockMarket, SurfClient, type SurfClientOptions, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, VideoClient, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, VoiceClient, type VoiceClientOptions, type VoiceInfo, type VoicePreset, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };