@blockrun/llm 1.2.0 → 1.3.1

package/dist/index.d.cts

@@ -504,6 +504,15 @@ declare class LLMClient {
      * Handle 402 response for raw endpoints: parse requirements, sign payment, retry.
      */
     private handlePaymentAndRetryRaw;
+    /**
+     * GET with automatic x402 payment handling, returning raw JSON.
+     * Used for Predexon prediction market endpoints that use GET + query params.
+     */
+    private getWithPaymentRaw;
+    /**
+     * Handle 402 response for GET endpoints: parse requirements, sign payment, retry with GET.
+     */
+    private handleGetPaymentAndRetryRaw;
     /**
      * Fetch with timeout.
      */
@@ -691,6 +700,33 @@ declare class LLMClient {
      * @param handle2 - Second X/Twitter handle (without @)
      */
     xCompareAuthors(handle1: string, handle2: string): Promise<XCompareAuthorsResponse>;
+    /**
+     * Query Predexon prediction market data (GET endpoints).
+     *
+     * Access real-time data from Polymarket, Kalshi, dFlow, and Binance Futures.
+     * Powered by Predexon. $0.001 per request.
+     *
+     * @param path - Endpoint path, e.g. "polymarket/events", "kalshi/markets/12345"
+     * @param params - Query parameters passed to the endpoint
+     *
+     * @example
+     * const events = await client.pm("polymarket/events");
+     * const market = await client.pm("kalshi/markets/KXBTC-25MAR14");
+     * const results = await client.pm("polymarket/search", { q: "bitcoin" });
+     */
+    pm(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /**
+     * Structured query for Predexon prediction market data (POST endpoints).
+     *
+     * For complex queries that require a JSON body. $0.005 per request.
+     *
+     * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+     * @param query - JSON body for the structured query
+     *
+     * @example
+     * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+     */
+    pmQuery(path: string, query: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
      *
@@ -898,9 +934,26 @@ declare function createWallet(): {
  * @returns Path to saved wallet file
  */
 declare function saveWallet(privateKey: string): string;
+/**
+ * Scan ~/.<dir>/wallet.json files from any provider (agentcash, etc.).
+ *
+ * Each file should contain JSON with "privateKey" and "address" fields.
+ * Results are sorted by modification time (most recent first).
+ *
+ * @returns Array of wallet objects with privateKey and address
+ */
+declare function scanWallets(): Array<{
+    privateKey: string;
+    address: string;
+}>;
 /**
  * Load wallet private key from file.
  *
+ * Priority:
+ * 1. Scan ~/.* /wallet.json (any provider)
+ * 2. Legacy ~/.blockrun/.session
+ * 3. Legacy ~/.blockrun/wallet.key
+ *
  * @returns Private key string or null if not found
  */
 declare function loadWallet(): string | null;
@@ -909,9 +962,10 @@ declare function loadWallet(): string | null;
  *
  * Priority:
  * 1. BLOCKRUN_WALLET_KEY environment variable
- * 2. ~/.blockrun/.session file
- * 3. ~/.blockrun/wallet.key file (legacy)
- * 4. Create new wallet
+ * 2. Scan wallet.json files from providers
+ * 3. ~/.blockrun/.session file
+ * 4. ~/.blockrun/wallet.key file - legacy
+ * 5. Create new wallet
  *
  * @returns WalletInfo with address, privateKey, and isNew flag
  */
@@ -1029,6 +1083,8 @@ declare class SolanaLLMClient {
     xArticlesRising(): Promise<XArticlesRisingResponse>;
     xAuthorAnalytics(handle: string): Promise<XAuthorAnalyticsResponse>;
     xCompareAuthors(handle1: string, handle2: string): Promise<XCompareAuthorsResponse>;
+    pm(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    pmQuery(path: string, query: Record<string, unknown>): Promise<Record<string, unknown>>;
     /** Get session spending. */
     getSpending(): Spending;
     /** True if using sol.blockrun.ai. */
@@ -1037,6 +1093,8 @@ declare class SolanaLLMClient {
     private handlePaymentAndRetry;
     private requestWithPaymentRaw;
     private handlePaymentAndRetryRaw;
+    private getWithPaymentRaw;
+    private handleGetPaymentAndRetryRaw;
     private fetchWithTimeout;
 }
 /**
@@ -1068,9 +1126,60 @@ declare function solanaKeyToBytes(privateKey: string): Promise<Uint8Array>;
  */
 declare function solanaPublicKey(privateKey: string): Promise<string>;
 declare function saveSolanaWallet(privateKey: string): string;
+/**
+ * Scan ~/.<dir>/solana-wallet.json files from any provider.
+ *
+ * Each file should contain JSON with "privateKey" and "address" fields.
+ * Also checks ~/.brcc/wallet.json for BRCC wallets.
+ * Results are sorted by modification time (most recent first).
+ *
+ * @returns Array of wallet objects with secretKey and publicKey
+ */
+declare function scanSolanaWallets(): Array<{
+    secretKey: string;
+    publicKey: string;
+}>;
 declare function loadSolanaWallet(): string | null;
 declare function getOrCreateSolanaWallet(): Promise<SolanaWalletInfo>;
 
+declare function getCached(key: string): unknown | null;
+declare function getCachedByRequest(endpoint: string, body: Record<string, unknown>): unknown | null;
+declare function setCache(key: string, data: unknown, ttlMs: number): void;
+declare function saveToCache(endpoint: string, body: Record<string, unknown>, response: unknown, costUsd?: number): void;
+declare function clearCache(): number;
+
+/**
+ * Agent wallet setup utilities.
+ *
+ * Convenience functions for agent runtimes (Claude Code skills, etc.)
+ * that auto-create wallets and return configured clients.
+ */
+
+declare function setupAgentWallet(options?: {
+    silent?: boolean;
+}): LLMClient;
+declare function setupAgentSolanaWallet(options?: {
+    silent?: boolean;
+}): Promise<SolanaLLMClient>;
+declare function status(): Promise<{
+    address: string;
+    balance: number;
+}>;
+
+interface CostEntry {
+    timestamp: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+}
+declare function logCost(entry: CostEntry): void;
+declare function getCostSummary(): {
+    totalUsd: number;
+    calls: number;
+    byModel: Record<string, number>;
+};
+
 /**
  * OpenAI-compatible API wrapper for BlockRun LLM SDK.
  *
@@ -1210,4 +1319,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 ImageEditOptions, 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 SearchOptions, type SearchParameters, type SearchResult, 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 XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, saveSolanaWallet, saveWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, testnetClient };
+export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, 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 SearchOptions, type SearchParameters, type SearchResult, 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 XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };

package/dist/index.d.ts

@@ -504,6 +504,15 @@ declare class LLMClient {
      * Handle 402 response for raw endpoints: parse requirements, sign payment, retry.
      */
     private handlePaymentAndRetryRaw;
+    /**
+     * GET with automatic x402 payment handling, returning raw JSON.
+     * Used for Predexon prediction market endpoints that use GET + query params.
+     */
+    private getWithPaymentRaw;
+    /**
+     * Handle 402 response for GET endpoints: parse requirements, sign payment, retry with GET.
+     */
+    private handleGetPaymentAndRetryRaw;
     /**
      * Fetch with timeout.
      */
@@ -691,6 +700,33 @@ declare class LLMClient {
      * @param handle2 - Second X/Twitter handle (without @)
      */
     xCompareAuthors(handle1: string, handle2: string): Promise<XCompareAuthorsResponse>;
+    /**
+     * Query Predexon prediction market data (GET endpoints).
+     *
+     * Access real-time data from Polymarket, Kalshi, dFlow, and Binance Futures.
+     * Powered by Predexon. $0.001 per request.
+     *
+     * @param path - Endpoint path, e.g. "polymarket/events", "kalshi/markets/12345"
+     * @param params - Query parameters passed to the endpoint
+     *
+     * @example
+     * const events = await client.pm("polymarket/events");
+     * const market = await client.pm("kalshi/markets/KXBTC-25MAR14");
+     * const results = await client.pm("polymarket/search", { q: "bitcoin" });
+     */
+    pm(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    /**
+     * Structured query for Predexon prediction market data (POST endpoints).
+     *
+     * For complex queries that require a JSON body. $0.005 per request.
+     *
+     * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+     * @param query - JSON body for the structured query
+     *
+     * @example
+     * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+     */
+    pmQuery(path: string, query: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
      * Get current session spending.
      *
@@ -898,9 +934,26 @@ declare function createWallet(): {
  * @returns Path to saved wallet file
  */
 declare function saveWallet(privateKey: string): string;
+/**
+ * Scan ~/.<dir>/wallet.json files from any provider (agentcash, etc.).
+ *
+ * Each file should contain JSON with "privateKey" and "address" fields.
+ * Results are sorted by modification time (most recent first).
+ *
+ * @returns Array of wallet objects with privateKey and address
+ */
+declare function scanWallets(): Array<{
+    privateKey: string;
+    address: string;
+}>;
 /**
  * Load wallet private key from file.
  *
+ * Priority:
+ * 1. Scan ~/.* /wallet.json (any provider)
+ * 2. Legacy ~/.blockrun/.session
+ * 3. Legacy ~/.blockrun/wallet.key
+ *
  * @returns Private key string or null if not found
  */
 declare function loadWallet(): string | null;
@@ -909,9 +962,10 @@ declare function loadWallet(): string | null;
  *
  * Priority:
  * 1. BLOCKRUN_WALLET_KEY environment variable
- * 2. ~/.blockrun/.session file
- * 3. ~/.blockrun/wallet.key file (legacy)
- * 4. Create new wallet
+ * 2. Scan wallet.json files from providers
+ * 3. ~/.blockrun/.session file
+ * 4. ~/.blockrun/wallet.key file - legacy
+ * 5. Create new wallet
  *
  * @returns WalletInfo with address, privateKey, and isNew flag
  */
@@ -1029,6 +1083,8 @@ declare class SolanaLLMClient {
     xArticlesRising(): Promise<XArticlesRisingResponse>;
     xAuthorAnalytics(handle: string): Promise<XAuthorAnalyticsResponse>;
     xCompareAuthors(handle1: string, handle2: string): Promise<XCompareAuthorsResponse>;
+    pm(path: string, params?: Record<string, string>): Promise<Record<string, unknown>>;
+    pmQuery(path: string, query: Record<string, unknown>): Promise<Record<string, unknown>>;
     /** Get session spending. */
     getSpending(): Spending;
     /** True if using sol.blockrun.ai. */
@@ -1037,6 +1093,8 @@ declare class SolanaLLMClient {
     private handlePaymentAndRetry;
     private requestWithPaymentRaw;
     private handlePaymentAndRetryRaw;
+    private getWithPaymentRaw;
+    private handleGetPaymentAndRetryRaw;
     private fetchWithTimeout;
 }
 /**
@@ -1068,9 +1126,60 @@ declare function solanaKeyToBytes(privateKey: string): Promise<Uint8Array>;
  */
 declare function solanaPublicKey(privateKey: string): Promise<string>;
 declare function saveSolanaWallet(privateKey: string): string;
+/**
+ * Scan ~/.<dir>/solana-wallet.json files from any provider.
+ *
+ * Each file should contain JSON with "privateKey" and "address" fields.
+ * Also checks ~/.brcc/wallet.json for BRCC wallets.
+ * Results are sorted by modification time (most recent first).
+ *
+ * @returns Array of wallet objects with secretKey and publicKey
+ */
+declare function scanSolanaWallets(): Array<{
+    secretKey: string;
+    publicKey: string;
+}>;
 declare function loadSolanaWallet(): string | null;
 declare function getOrCreateSolanaWallet(): Promise<SolanaWalletInfo>;
 
+declare function getCached(key: string): unknown | null;
+declare function getCachedByRequest(endpoint: string, body: Record<string, unknown>): unknown | null;
+declare function setCache(key: string, data: unknown, ttlMs: number): void;
+declare function saveToCache(endpoint: string, body: Record<string, unknown>, response: unknown, costUsd?: number): void;
+declare function clearCache(): number;
+
+/**
+ * Agent wallet setup utilities.
+ *
+ * Convenience functions for agent runtimes (Claude Code skills, etc.)
+ * that auto-create wallets and return configured clients.
+ */
+
+declare function setupAgentWallet(options?: {
+    silent?: boolean;
+}): LLMClient;
+declare function setupAgentSolanaWallet(options?: {
+    silent?: boolean;
+}): Promise<SolanaLLMClient>;
+declare function status(): Promise<{
+    address: string;
+    balance: number;
+}>;
+
+interface CostEntry {
+    timestamp: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+}
+declare function logCost(entry: CostEntry): void;
+declare function getCostSummary(): {
+    totalUsd: number;
+    calls: number;
+    byModel: Record<string, number>;
+};
+
 /**
  * OpenAI-compatible API wrapper for BlockRun LLM SDK.
  *
@@ -1210,4 +1319,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 ImageEditOptions, 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 SearchOptions, type SearchParameters, type SearchResult, 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 XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, saveSolanaWallet, saveWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, testnetClient };
+export { APIError, BASE_CHAIN_ID, BlockrunError, type ChatChoice, type ChatCompletionOptions, type ChatMessage, type ChatOptions, type ChatResponse, type ChatUsage, type CostEntry, type FunctionCall, type FunctionDefinition, ImageClient, type ImageClientOptions, type ImageData, type ImageEditOptions, 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 SearchOptions, type SearchParameters, type SearchResult, 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 XArticlesRisingResponse, type XAuthorAnalyticsResponse, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsResponse, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XVerifiedFollowersResponse, clearCache, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, testnetClient };