@blockrun/llm 0.3.0 → 1.1.0

package/dist/index.d.cts

@@ -179,6 +179,32 @@ interface ChatCompletionOptions {
     /** Tool selection strategy */
     toolChoice?: ToolChoice;
 }
+type RoutingProfile = "free" | "eco" | "auto" | "premium";
+type RoutingTier = "SIMPLE" | "MEDIUM" | "COMPLEX" | "REASONING";
+interface RoutingDecision {
+    model: string;
+    tier: RoutingTier;
+    confidence: number;
+    method: "rules" | "llm";
+    reasoning: string;
+    costEstimate: number;
+    baselineCost: number;
+    savings: number;
+}
+interface SmartChatOptions extends ChatOptions {
+    /** Routing profile: free (zero cost), eco (budget), auto (balanced), premium (best quality) */
+    routingProfile?: RoutingProfile;
+    /** Maximum output tokens (used for cost estimation) */
+    maxOutputTokens?: number;
+}
+interface SmartChatResponse {
+    /** The AI response text */
+    response: string;
+    /** Which model was selected by smart routing */
+    model: string;
+    /** Routing decision metadata */
+    routing: RoutingDecision;
+}
 declare class BlockrunError extends Error {
     constructor(message: string);
 }
@@ -240,6 +266,8 @@ declare class LLMClient {
     private timeout;
     private sessionTotalUsd;
     private sessionCalls;
+    private modelPricingCache;
+    private modelPricingPromise;
     /**
      * Initialize the BlockRun LLM client.
      *
@@ -259,6 +287,46 @@ declare class LLMClient {
      * console.log(response); // 'The capital of France is Paris.'
      */
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    /**
+     * Smart chat with automatic model routing.
+     *
+     * Uses ClawRouter's 14-dimension rule-based scoring algorithm (<1ms, 100% local)
+     * to select the cheapest model that can handle your request.
+     *
+     * @param prompt - User message
+     * @param options - Optional chat and routing parameters
+     * @returns SmartChatResponse with response text, selected model, and routing metadata
+     *
+     * @example Simple usage (auto profile)
+     * ```ts
+     * const result = await client.smartChat('What is 2+2?');
+     * console.log(result.response); // '4'
+     * console.log(result.model); // 'google/gemini-2.5-flash-lite'
+     * console.log(result.routing.savings); // 0.78 (78% savings)
+     * ```
+     *
+     * @example With routing profile
+     * ```ts
+     * // Free tier only (zero cost)
+     * const result = await client.smartChat('Hello!', { routingProfile: 'free' });
+     *
+     * // Eco mode (budget optimized)
+     * const result = await client.smartChat('Explain quantum computing', { routingProfile: 'eco' });
+     *
+     * // Premium mode (best quality)
+     * const result = await client.smartChat('Write a business plan', { routingProfile: 'premium' });
+     * ```
+     */
+    smartChat(prompt: string, options?: SmartChatOptions): Promise<SmartChatResponse>;
+    /**
+     * Get model pricing map (cached).
+     * Fetches from API on first call, then returns cached result.
+     */
+    private getModelPricing;
+    /**
+     * Fetch model pricing from API.
+     */
+    private fetchModelPricing;
     /**
      * Full chat completion interface (OpenAI-compatible).
      *
@@ -434,6 +502,33 @@ declare class ImageClient {
 
 declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface CreateSolanaPaymentOptions {
+    resourceUrl?: string;
+    resourceDescription?: string;
+    maxTimeoutSeconds?: number;
+    extra?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+    rpcUrl?: string;
+}
+/**
+ * Create a signed Solana x402 v2 payment payload.
+ *
+ * This creates an SPL TransferChecked transaction for USDC payment
+ * that the CDP facilitator can verify and settle.
+ *
+ * Requires @solana/web3.js and @solana/spl-token dependencies.
+ *
+ * @param secretKey - Solana secret key (Uint8Array, 64 bytes)
+ * @param fromAddress - Sender wallet address (base58)
+ * @param recipient - Payment recipient address (base58)
+ * @param amount - Amount in micro USDC (6 decimals)
+ * @param feePayer - CDP facilitator fee payer address (base58)
+ * @param options - Additional options
+ * @returns Base64-encoded signed payment payload
+ */
+declare function createSolanaPaymentPayload(secretKey: Uint8Array, fromAddress: string, recipient: string, amount: string, feePayer: string, options?: CreateSolanaPaymentOptions): Promise<string>;
 
 /**
  * BlockRun Wallet Management - Auto-create and manage wallets.
@@ -534,6 +629,89 @@ declare function formatFundingMessageCompact(address: string): string;
 declare const WALLET_FILE_PATH: string;
 declare const WALLET_DIR_PATH: string;
 
+/**
+ * BlockRun Solana LLM Client.
+ *
+ * Usage:
+ *   import { SolanaLLMClient } from '@blockrun/llm';
+ *
+ *   // SOLANA_WALLET_KEY env var (bs58-encoded Solana secret key)
+ *   const client = new SolanaLLMClient();
+ *
+ *   // Or pass key directly
+ *   const client = new SolanaLLMClient({ privateKey: 'your-bs58-key' });
+ *
+ *   const response = await client.chat('openai/gpt-4o', 'gm Solana');
+ */
+
+interface SolanaLLMClientOptions {
+    /** bs58-encoded Solana secret key (64 bytes). Optional if SOLANA_WALLET_KEY env var is set. */
+    privateKey?: string;
+    /** API endpoint URL (default: https://sol.blockrun.ai/api) */
+    apiUrl?: string;
+    /** Solana RPC URL (default: https://api.mainnet-beta.solana.com) */
+    rpcUrl?: string;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeout?: number;
+}
+declare class SolanaLLMClient {
+    static readonly SOLANA_API_URL = "https://sol.blockrun.ai/api";
+    private privateKey;
+    private apiUrl;
+    private rpcUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    private addressCache;
+    constructor(options?: SolanaLLMClientOptions);
+    /** Get Solana wallet address (public key in base58). */
+    getWalletAddress(): Promise<string>;
+    /** Simple 1-line chat. */
+    chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    /** Full chat completion (OpenAI-compatible). */
+    chatCompletion(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatResponse>;
+    /** List available models. */
+    listModels(): Promise<Model[]>;
+    /** Get session spending. */
+    getSpending(): Spending;
+    /** True if using sol.blockrun.ai. */
+    isSolana(): boolean;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+}
+/**
+ * Convenience function: create SolanaLLMClient for sol.blockrun.ai.
+ */
+declare function solanaClient(options?: SolanaLLMClientOptions): SolanaLLMClient;
+
+declare const SOLANA_WALLET_FILE: string;
+interface SolanaWalletInfo {
+    privateKey: string;
+    address: string;
+    isNew: boolean;
+}
+/**
+ * Create a new Solana wallet.
+ * Requires @solana/web3.js (optional dep).
+ */
+declare function createSolanaWallet(): {
+    address: string;
+    privateKey: string;
+};
+/**
+ * Convert a bs58 private key string to Uint8Array (64 bytes).
+ * Accepts: bs58-encoded 64-byte key (standard Solana format).
+ */
+declare function solanaKeyToBytes(privateKey: string): Promise<Uint8Array>;
+/**
+ * Get Solana public key (address) from bs58 private key.
+ */
+declare function solanaPublicKey(privateKey: string): Promise<string>;
+declare function saveSolanaWallet(privateKey: string): string;
+declare function loadSolanaWallet(): string | null;
+declare function getOrCreateSolanaWallet(): Promise<SolanaWalletInfo>;
+
 /**
  * OpenAI-compatible API wrapper for BlockRun LLM SDK.
  *
@@ -673,4 +851,4 @@ declare class OpenAI {
     getWalletAddress(): string;
 }
 
-export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RssSearchSource, type SearchParameters, type SearchSource, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadWallet, saveWallet, testnetClient };
+export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchParameters, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, saveSolanaWallet, saveWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, testnetClient };

package/dist/index.d.ts

@@ -179,6 +179,32 @@ interface ChatCompletionOptions {
     /** Tool selection strategy */
     toolChoice?: ToolChoice;
 }
+type RoutingProfile = "free" | "eco" | "auto" | "premium";
+type RoutingTier = "SIMPLE" | "MEDIUM" | "COMPLEX" | "REASONING";
+interface RoutingDecision {
+    model: string;
+    tier: RoutingTier;
+    confidence: number;
+    method: "rules" | "llm";
+    reasoning: string;
+    costEstimate: number;
+    baselineCost: number;
+    savings: number;
+}
+interface SmartChatOptions extends ChatOptions {
+    /** Routing profile: free (zero cost), eco (budget), auto (balanced), premium (best quality) */
+    routingProfile?: RoutingProfile;
+    /** Maximum output tokens (used for cost estimation) */
+    maxOutputTokens?: number;
+}
+interface SmartChatResponse {
+    /** The AI response text */
+    response: string;
+    /** Which model was selected by smart routing */
+    model: string;
+    /** Routing decision metadata */
+    routing: RoutingDecision;
+}
 declare class BlockrunError extends Error {
     constructor(message: string);
 }
@@ -240,6 +266,8 @@ declare class LLMClient {
     private timeout;
     private sessionTotalUsd;
     private sessionCalls;
+    private modelPricingCache;
+    private modelPricingPromise;
     /**
      * Initialize the BlockRun LLM client.
      *
@@ -259,6 +287,46 @@ declare class LLMClient {
      * console.log(response); // 'The capital of France is Paris.'
      */
     chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    /**
+     * Smart chat with automatic model routing.
+     *
+     * Uses ClawRouter's 14-dimension rule-based scoring algorithm (<1ms, 100% local)
+     * to select the cheapest model that can handle your request.
+     *
+     * @param prompt - User message
+     * @param options - Optional chat and routing parameters
+     * @returns SmartChatResponse with response text, selected model, and routing metadata
+     *
+     * @example Simple usage (auto profile)
+     * ```ts
+     * const result = await client.smartChat('What is 2+2?');
+     * console.log(result.response); // '4'
+     * console.log(result.model); // 'google/gemini-2.5-flash-lite'
+     * console.log(result.routing.savings); // 0.78 (78% savings)
+     * ```
+     *
+     * @example With routing profile
+     * ```ts
+     * // Free tier only (zero cost)
+     * const result = await client.smartChat('Hello!', { routingProfile: 'free' });
+     *
+     * // Eco mode (budget optimized)
+     * const result = await client.smartChat('Explain quantum computing', { routingProfile: 'eco' });
+     *
+     * // Premium mode (best quality)
+     * const result = await client.smartChat('Write a business plan', { routingProfile: 'premium' });
+     * ```
+     */
+    smartChat(prompt: string, options?: SmartChatOptions): Promise<SmartChatResponse>;
+    /**
+     * Get model pricing map (cached).
+     * Fetches from API on first call, then returns cached result.
+     */
+    private getModelPricing;
+    /**
+     * Fetch model pricing from API.
+     */
+    private fetchModelPricing;
     /**
      * Full chat completion interface (OpenAI-compatible).
      *
@@ -434,6 +502,33 @@ declare class ImageClient {
 
 declare const BASE_CHAIN_ID = 8453;
 declare const USDC_BASE: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+declare const SOLANA_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+declare const USDC_SOLANA = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface CreateSolanaPaymentOptions {
+    resourceUrl?: string;
+    resourceDescription?: string;
+    maxTimeoutSeconds?: number;
+    extra?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+    rpcUrl?: string;
+}
+/**
+ * Create a signed Solana x402 v2 payment payload.
+ *
+ * This creates an SPL TransferChecked transaction for USDC payment
+ * that the CDP facilitator can verify and settle.
+ *
+ * Requires @solana/web3.js and @solana/spl-token dependencies.
+ *
+ * @param secretKey - Solana secret key (Uint8Array, 64 bytes)
+ * @param fromAddress - Sender wallet address (base58)
+ * @param recipient - Payment recipient address (base58)
+ * @param amount - Amount in micro USDC (6 decimals)
+ * @param feePayer - CDP facilitator fee payer address (base58)
+ * @param options - Additional options
+ * @returns Base64-encoded signed payment payload
+ */
+declare function createSolanaPaymentPayload(secretKey: Uint8Array, fromAddress: string, recipient: string, amount: string, feePayer: string, options?: CreateSolanaPaymentOptions): Promise<string>;
 
 /**
  * BlockRun Wallet Management - Auto-create and manage wallets.
@@ -534,6 +629,89 @@ declare function formatFundingMessageCompact(address: string): string;
 declare const WALLET_FILE_PATH: string;
 declare const WALLET_DIR_PATH: string;
 
+/**
+ * BlockRun Solana LLM Client.
+ *
+ * Usage:
+ *   import { SolanaLLMClient } from '@blockrun/llm';
+ *
+ *   // SOLANA_WALLET_KEY env var (bs58-encoded Solana secret key)
+ *   const client = new SolanaLLMClient();
+ *
+ *   // Or pass key directly
+ *   const client = new SolanaLLMClient({ privateKey: 'your-bs58-key' });
+ *
+ *   const response = await client.chat('openai/gpt-4o', 'gm Solana');
+ */
+
+interface SolanaLLMClientOptions {
+    /** bs58-encoded Solana secret key (64 bytes). Optional if SOLANA_WALLET_KEY env var is set. */
+    privateKey?: string;
+    /** API endpoint URL (default: https://sol.blockrun.ai/api) */
+    apiUrl?: string;
+    /** Solana RPC URL (default: https://api.mainnet-beta.solana.com) */
+    rpcUrl?: string;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeout?: number;
+}
+declare class SolanaLLMClient {
+    static readonly SOLANA_API_URL = "https://sol.blockrun.ai/api";
+    private privateKey;
+    private apiUrl;
+    private rpcUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    private addressCache;
+    constructor(options?: SolanaLLMClientOptions);
+    /** Get Solana wallet address (public key in base58). */
+    getWalletAddress(): Promise<string>;
+    /** Simple 1-line chat. */
+    chat(model: string, prompt: string, options?: ChatOptions): Promise<string>;
+    /** Full chat completion (OpenAI-compatible). */
+    chatCompletion(model: string, messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatResponse>;
+    /** List available models. */
+    listModels(): Promise<Model[]>;
+    /** Get session spending. */
+    getSpending(): Spending;
+    /** True if using sol.blockrun.ai. */
+    isSolana(): boolean;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+}
+/**
+ * Convenience function: create SolanaLLMClient for sol.blockrun.ai.
+ */
+declare function solanaClient(options?: SolanaLLMClientOptions): SolanaLLMClient;
+
+declare const SOLANA_WALLET_FILE: string;
+interface SolanaWalletInfo {
+    privateKey: string;
+    address: string;
+    isNew: boolean;
+}
+/**
+ * Create a new Solana wallet.
+ * Requires @solana/web3.js (optional dep).
+ */
+declare function createSolanaWallet(): {
+    address: string;
+    privateKey: string;
+};
+/**
+ * Convert a bs58 private key string to Uint8Array (64 bytes).
+ * Accepts: bs58-encoded 64-byte key (standard Solana format).
+ */
+declare function solanaKeyToBytes(privateKey: string): Promise<Uint8Array>;
+/**
+ * Get Solana public key (address) from bs58 private key.
+ */
+declare function solanaPublicKey(privateKey: string): Promise<string>;
+declare function saveSolanaWallet(privateKey: string): string;
+declare function loadSolanaWallet(): string | null;
+declare function getOrCreateSolanaWallet(): Promise<SolanaWalletInfo>;
+
 /**
  * OpenAI-compatible API wrapper for BlockRun LLM SDK.
  *
@@ -673,4 +851,4 @@ declare class OpenAI {
     getWalletAddress(): string;
 }
 
-export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RssSearchSource, type SearchParameters, type SearchSource, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadWallet, saveWallet, testnetClient };
+export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageGenerateOptions, type ImageModel, type ImageResponse, LLMClient, type LLMClientOptions, type Model, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, type SearchParameters, type SearchSource, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, type Spending, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, WALLET_DIR_PATH, WALLET_FILE_PATH, type WalletInfo, type WebSearchSource, type XSearchSource, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, saveSolanaWallet, saveWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, testnetClient };

package/dist/{index.esm-WP2DIBSK.js → index.esm-SXKIFLA7.js}

@@ -73,10 +73,11 @@ import {
   VoteInstruction,
   VoteProgram,
   clusterApiUrl,
+  init_index_esm,
   sendAndConfirmRawTransaction,
   sendAndConfirmTransaction
-} from "./chunk-S7BEMV6T.js";
-import "./chunk-2ESYSVXG.js";
+} from "./chunk-KRDGCX7W.js";
+init_index_esm();
 export {
   Account,
   AddressLookupTableAccount,