@blockrun/llm 2.13.0 → 3.0.0

package/dist/index.d.ts

@@ -727,130 +727,6 @@ interface ExaFindSimilarOptions {
     /** Exclude pages from the same domain as the reference URL */
     excludeSourceDomain?: boolean;
 }
-interface XUser {
-    id: string;
-    userName: string;
-    name: string;
-    profilePicture?: string;
-    description?: string;
-    followers?: number;
-    following?: number;
-    isBlueVerified?: boolean;
-    verifiedType?: string;
-    location?: string;
-    joined?: string;
-}
-interface XUserLookupResponse {
-    users: XUser[];
-    not_found?: string[];
-    total_requested?: number;
-    total_found?: number;
-}
-interface XFollower {
-    id: string;
-    name?: string;
-    screen_name?: string;
-    userName?: string;
-    location?: string;
-    description?: string;
-    protected?: boolean;
-    verified?: boolean;
-    followers_count?: number;
-    following_count?: number;
-    favourites_count?: number;
-    statuses_count?: number;
-    created_at?: string;
-    profile_image_url_https?: string;
-    can_dm?: boolean;
-}
-interface XFollowersResponse {
-    followers: XFollower[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-    username?: string;
-}
-interface XFollowingsResponse {
-    followings: XFollower[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-    username?: string;
-}
-interface XUserInfoResponse {
-    data: Record<string, unknown>;
-    username?: string;
-}
-interface XVerifiedFollowersResponse {
-    followers: XFollower[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-}
-interface XTweet {
-    id: string;
-    text?: string;
-    created_at?: string;
-    author?: Record<string, unknown>;
-    favorite_count?: number;
-    retweet_count?: number;
-    reply_count?: number;
-    view_count?: number;
-    lang?: string;
-    entities?: Record<string, unknown>;
-    media?: Array<Record<string, unknown>>;
-    [key: string]: unknown;
-}
-interface XTweetsResponse {
-    tweets: XTweet[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-}
-interface XMentionsResponse {
-    tweets: XTweet[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-    username?: string;
-}
-interface XTweetLookupResponse {
-    tweets: XTweet[];
-    not_found?: string[];
-    total_requested?: number;
-    total_found?: number;
-}
-interface XTweetRepliesResponse {
-    replies: XTweet[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-}
-interface XTweetThreadResponse {
-    tweets: XTweet[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-}
-interface XSearchResponse {
-    tweets: XTweet[];
-    has_next_page?: boolean;
-    next_cursor?: string;
-    total_returned?: number;
-}
-interface XTrendingResponse {
-    data: Record<string, unknown>;
-}
-interface XArticlesRisingResponse {
-    data: Record<string, unknown>;
-}
-interface XAuthorAnalyticsResponse {
-    data: Record<string, unknown>;
-    handle?: string;
-}
-interface XCompareAuthorsResponse {
-    data: Record<string, unknown>;
-}
 type PriceCategory = "crypto" | "fx" | "commodity" | "usstock" | "stocks";
 type StockMarket = "us" | "hk" | "jp" | "kr" | "gb" | "de" | "fr" | "nl" | "ie" | "lu" | "cn" | "ca";
 type BarResolution = "1" | "5" | "15" | "60" | "240" | "D" | "W" | "M";
@@ -913,11 +789,6 @@ interface SearchClientOptions {
     apiUrl?: string;
     timeout?: number;
 }
-interface XClientOptions {
-    privateKey?: `0x${string}` | string;
-    apiUrl?: string;
-    timeout?: number;
-}
 interface PriceClientOptions {
     privateKey?: `0x${string}` | string;
     apiUrl?: string;
@@ -1359,136 +1230,6 @@ declare class LLMClient {
      * console.log(`Balance: $${balance.toFixed(2)} USDC`);
      */
     getBalance(): Promise<number>;
-    /**
-     * Look up X/Twitter user profiles by username.
-     *
-     * Powered by AttentionVC. $0.002 per user (min $0.02, max $0.20).
-     *
-     * @param usernames - Single username or array of usernames (without @)
-     */
-    xUserLookup(usernames: string | string[]): Promise<XUserLookupResponse>;
-    /**
-     * Get followers of an X/Twitter user.
-     *
-     * Powered by AttentionVC. $0.05 per page (~200 accounts).
-     *
-     * @param username - X/Twitter username (without @)
-     * @param cursor - Pagination cursor from previous response
-     */
-    xFollowers(username: string, cursor?: string): Promise<XFollowersResponse>;
-    /**
-     * Get accounts an X/Twitter user is following.
-     *
-     * Powered by AttentionVC. $0.05 per page (~200 accounts).
-     *
-     * @param username - X/Twitter username (without @)
-     * @param cursor - Pagination cursor from previous response
-     */
-    xFollowings(username: string, cursor?: string): Promise<XFollowingsResponse>;
-    /**
-     * Get detailed profile info for a single X/Twitter user.
-     *
-     * Powered by AttentionVC. $0.002 per request.
-     *
-     * @param username - X/Twitter username (without @)
-     */
-    xUserInfo(username: string): Promise<XUserInfoResponse>;
-    /**
-     * Get verified (blue-check) followers of an X/Twitter user.
-     *
-     * Powered by AttentionVC. $0.048 per page.
-     *
-     * @param userId - X/Twitter user ID (not username)
-     * @param cursor - Pagination cursor from previous response
-     */
-    xVerifiedFollowers(userId: string, cursor?: string): Promise<XVerifiedFollowersResponse>;
-    /**
-     * Get tweets posted by an X/Twitter user.
-     *
-     * Powered by AttentionVC. $0.032 per page.
-     *
-     * @param username - X/Twitter username (without @)
-     * @param includeReplies - Include reply tweets (default: false)
-     * @param cursor - Pagination cursor from previous response
-     */
-    xUserTweets(username: string, includeReplies?: boolean, cursor?: string): Promise<XTweetsResponse>;
-    /**
-     * Get tweets that mention an X/Twitter user.
-     *
-     * Powered by AttentionVC. $0.032 per page.
-     *
-     * @param username - X/Twitter username (without @)
-     * @param sinceTime - Start time filter (ISO8601 or Unix timestamp)
-     * @param untilTime - End time filter (ISO8601 or Unix timestamp)
-     * @param cursor - Pagination cursor from previous response
-     */
-    xUserMentions(username: string, sinceTime?: string, untilTime?: string, cursor?: string): Promise<XMentionsResponse>;
-    /**
-     * Fetch full tweet data for up to 200 tweet IDs.
-     *
-     * Powered by AttentionVC. $0.16 per batch.
-     *
-     * @param tweetIds - Single tweet ID or array of tweet IDs (max 200)
-     */
-    xTweetLookup(tweetIds: string | string[]): Promise<XTweetLookupResponse>;
-    /**
-     * Get replies to a specific tweet.
-     *
-     * Powered by AttentionVC. $0.032 per page.
-     *
-     * @param tweetId - The tweet ID to get replies for
-     * @param queryType - Sort order: 'Latest' or 'Default'
-     * @param cursor - Pagination cursor from previous response
-     */
-    xTweetReplies(tweetId: string, queryType?: string, cursor?: string): Promise<XTweetRepliesResponse>;
-    /**
-     * Get the full thread context for a tweet.
-     *
-     * Powered by AttentionVC. $0.032 per page.
-     *
-     * @param tweetId - The tweet ID to get thread for
-     * @param cursor - Pagination cursor from previous response
-     */
-    xTweetThread(tweetId: string, cursor?: string): Promise<XTweetThreadResponse>;
-    /**
-     * Search X/Twitter with advanced query operators.
-     *
-     * Powered by AttentionVC. $0.032 per page.
-     *
-     * @param query - Search query (supports Twitter search operators)
-     * @param queryType - Sort order: 'Latest', 'Top', or 'Default'
-     * @param cursor - Pagination cursor from previous response
-     */
-    xSearch(query: string, queryType?: string, cursor?: string): Promise<XSearchResponse>;
-    /**
-     * Get current trending topics on X/Twitter.
-     *
-     * Powered by AttentionVC. $0.002 per request.
-     */
-    xTrending(): Promise<XTrendingResponse>;
-    /**
-     * Get rising/viral articles from X/Twitter.
-     *
-     * Powered by AttentionVC intelligence layer. $0.05 per request.
-     */
-    xArticlesRising(): Promise<XArticlesRisingResponse>;
-    /**
-     * Get author analytics and intelligence metrics for an X/Twitter user.
-     *
-     * Powered by AttentionVC intelligence layer. $0.02 per request.
-     *
-     * @param handle - X/Twitter handle (without @)
-     */
-    xAuthorAnalytics(handle: string): Promise<XAuthorAnalyticsResponse>;
-    /**
-     * Compare two X/Twitter authors side-by-side with intelligence metrics.
-     *
-     * Powered by AttentionVC intelligence layer. $0.05 per request.
-     *
-     * @param handle1 - First X/Twitter handle (without @)
-     * @param handle2 - Second X/Twitter handle (without @)
-     */
-    xCompareAuthors(handle1: string, handle2: string): Promise<XCompareAuthorsResponse>;
     /**
      * Query Predexon prediction market data (GET endpoints).
      *
@@ -2178,78 +1919,6 @@ declare class SearchClient {
     getWalletAddress(): string;
 }
 
-/**
- * BlockRun X (Twitter) Client - AttentionVC-partnered X/Twitter API via x402.
- *
- * Wraps the /api/v1/x/* endpoint family. Every call is gated by an x402
- * payment; the client handles the 402 → sign → retry dance automatically.
- *
- * Usage:
- *   import { XClient } from "@blockrun/llm";
- *
- *   const x = new XClient({ privateKey: "0x..." });
- *   const info = await x.userInfo("elonmusk");
- *   const followers = await x.followers("paulg");
- *   const results = await x.search("x402 micropayments", { queryType: "Latest" });
- */
-
-interface XUserTweetsOptions {
-    username?: string;
-    userId?: string;
-    cursor?: string;
-    includeReplies?: boolean;
-}
-interface XMentionsOptions {
-    sinceTime?: string;
-    untilTime?: string;
-    cursor?: string;
-}
-interface XTweetRepliesOptions {
-    cursor?: string;
-    queryType?: "Latest" | "Default";
-}
-interface XSearchOptions {
-    queryType?: "Latest" | "Top" | "Default";
-    cursor?: string;
-}
-/**
- * BlockRun X/Twitter client.
- *
- * @deprecated BlockRun's `/v1/x/*` (AttentionVC-partnered) integration was
- * removed from the backend on 2026-04-30 (commit 80dcf52). All `XClient`
- * calls will return HTTP 404 until a replacement upstream is wired up.
- * The class is kept in the SDK so existing imports do not break;
- * instantiation logs a one-time `console.warn`.
- */
-declare class XClient {
-    private account;
-    private privateKey;
-    private apiUrl;
-    private timeout;
-    private static deprecationWarned;
-    constructor(options?: XClientOptions);
-    userLookup(usernames: string | string[]): Promise<XUserLookupResponse>;
-    userInfo(username: string): Promise<XUserInfoResponse>;
-    followers(username: string, cursor?: string): Promise<XFollowersResponse>;
-    /** `/v1/x/users/following` (singular path variant). */
-    following(username: string, cursor?: string): Promise<XFollowingsResponse>;
-    /** `/v1/x/users/followings` (plural path variant). */
-    followings(username: string, cursor?: string): Promise<XFollowingsResponse>;
-    verifiedFollowers(userId: string, cursor?: string): Promise<XVerifiedFollowersResponse>;
-    userTweets(options: XUserTweetsOptions): Promise<XTweetsResponse>;
-    mentions(username: string, options?: XMentionsOptions): Promise<XMentionsResponse>;
-    tweetLookup(tweetIds: string | string[]): Promise<XTweetLookupResponse>;
-    tweetReplies(tweetId: string, options?: XTweetRepliesOptions): Promise<XTweetRepliesResponse>;
-    tweetThread(tweetId: string, cursor?: string): Promise<XTweetThreadResponse>;
-    search(query: string, options?: XSearchOptions): Promise<XSearchResponse>;
-    trending(): Promise<XTrendingResponse>;
-    articlesRising(): Promise<XArticlesRisingResponse>;
-    private post;
-    private payAndRetry;
-    private fetchWithTimeout;
-    getWalletAddress(): string;
-}
-
 /**
  * BlockRun Price Client - Pyth-backed market data via x402.
  *
@@ -2875,21 +2544,6 @@ declare class SolanaLLMClient {
     imageEdit(prompt: string, image: string | string[], options?: ImageEditOptions): Promise<ImageResponse>;
     /** Standalone search (Solana payment). */
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
-    xUserLookup(usernames: string | string[]): Promise<XUserLookupResponse>;
-    xFollowers(username: string, cursor?: string): Promise<XFollowersResponse>;
-    xFollowings(username: string, cursor?: string): Promise<XFollowingsResponse>;
-    xUserInfo(username: string): Promise<XUserInfoResponse>;
-    xVerifiedFollowers(userId: string, cursor?: string): Promise<XVerifiedFollowersResponse>;
-    xUserTweets(username: string, includeReplies?: boolean, cursor?: string): Promise<XTweetsResponse>;
-    xUserMentions(username: string, sinceTime?: string, untilTime?: string, cursor?: string): Promise<XMentionsResponse>;
-    xTweetLookup(tweetIds: string | string[]): Promise<XTweetLookupResponse>;
-    xTweetReplies(tweetId: string, queryType?: string, cursor?: string): Promise<XTweetRepliesResponse>;
-    xTweetThread(tweetId: string, cursor?: string): Promise<XTweetThreadResponse>;
-    xSearch(query: string, queryType?: string, cursor?: string): Promise<XSearchResponse>;
-    xTrending(): Promise<XTrendingResponse>;
-    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>>;
     /**
@@ -3257,4 +2911,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, type RoutingDecision, type RoutingProfile, type RoutingTier, 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 XArticlesRisingResponse, type XAuthorAnalyticsResponse, XClient, type XClientOptions, type XCompareAuthorsResponse, type XFollower, type XFollowersResponse, type XFollowingsResponse, type XMentionsOptions, type XMentionsResponse, type XSearchOptions, type XSearchResponse, type XSearchSource, type XTrendingResponse, type XTweet, type XTweetLookupResponse, type XTweetRepliesOptions, type XTweetRepliesResponse, type XTweetThreadResponse, type XTweetsResponse, type XUser, type XUserInfoResponse, type XUserLookupResponse, type XUserTweetsOptions, type XVerifiedFollowersResponse, clearCache, createPaymentPayload, createSolanaPaymentPayload, createSolanaWallet, createWallet, LLMClient as default, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, 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, type RoutingDecision, type RoutingProfile, type RoutingTier, 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, formatWalletCreatedMessage, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };