@blockrun/llm 2.4.0 → 2.7.0

package/dist/index.d.ts

@@ -494,6 +494,13 @@ interface VideoGenerateOptions {
     model?: "xai/grok-imagine-video" | string;
     /** Optional seed image URL for image-to-video */
     imageUrl?: string;
+    /**
+     * Virtual Portrait asset ID (`ta_xxxxxx`) — keeps the same AI character
+     * across multiple Seedance videos. Enroll via `POST /v1/portrait/enroll`
+     * ($0.50 USDC, no KYC). **Seedance 2.0 fast/pro only.** Mutually exclusive
+     * with `imageUrl`. Real-person likeness is not supported on BlockRun.
+     */
+    realFaceAssetId?: string;
     /** Duration to bill for (defaults to model's default duration) */
     durationSeconds?: number;
     /** Output aspect ratio. Token360 / Seedance only — silently ignored by xAI Grok. */
@@ -501,11 +508,12 @@ interface VideoGenerateOptions {
     /** Output resolution. Token360 / Seedance only. */
     resolution?: "360p" | "480p" | "540p" | "720p" | "1080p" | "1K" | "2K" | "4K";
     /**
-     * Whether the model should produce an audio track. Token360 / Seedance only.
-     * When omitted, the gateway does not send the flag — Token360 then applies
-     * its own upstream default (typically off, occasionally on depending on
-     * model variant / prompt). Audio generation is usually a paid surcharge,
-     * so callers should expose this as a visible toggle to their users.
+     * Whether the model should produce a synced audio track. Token360 / Seedance
+     * only — silently ignored by xAI Grok. When omitted, the gateway defaults to
+     * `true` for text-to-video and `false` for image- or face-conditioned
+     * generation (the t2v / i2v split that matches Token360's quality profile).
+     * Pass an explicit boolean to override. Audio generation may be a paid
+     * surcharge upstream, so callers should expose this as a visible toggle.
      */
     generateAudio?: boolean;
     /** Reproducibility seed when supported by the model. */
@@ -790,6 +798,88 @@ interface SurfClientOptions {
     apiUrl?: string;
     timeout?: number;
 }
+interface PhoneClientOptions {
+    /** EVM wallet private key (hex string starting with 0x) */
+    privateKey?: `0x${string}` | string;
+    /** API endpoint URL (default: https://blockrun.ai/api) */
+    apiUrl?: string;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeout?: number;
+}
+/**
+ * Twilio Lookup passthrough — shape comes from upstream and varies by feature
+ * (basic vs `line_type_intelligence`, `sim_swap`, `call_forwarding`).
+ * Typed as a permissive record so future Twilio fields don't require an SDK release.
+ */
+interface PhoneLookupResponse {
+    phone_number?: string;
+    country_code?: string;
+    national_format?: string;
+    caller_name?: Record<string, unknown> | null;
+    carrier?: Record<string, unknown> | null;
+    line_type_intelligence?: Record<string, unknown> | null;
+    sim_swap?: Record<string, unknown> | null;
+    call_forwarding?: Record<string, unknown> | null;
+    /** Pass-through for anything Twilio adds. */
+    [key: string]: unknown;
+}
+interface PhoneBuyOptions {
+    /** ISO country code, "US" or "CA" (default "US"). */
+    country?: "US" | "CA";
+    /**
+     * Optional 3-digit area-code hint. Availability is not guaranteed — the
+     * backend falls back to any number in the country if the area code
+     * can't be matched.
+     */
+    areaCode?: string;
+}
+interface PhoneBuyResponse {
+    /** The E.164 number now bound to your wallet. */
+    phone_number: string;
+    /** ISO-8601 expiry (30 days out from purchase). */
+    expires_at: string;
+    /** "base" | "solana" — settlement chain. */
+    chain: string;
+    /** Human-readable note. */
+    message?: string;
+    /** On-chain payment receipt (tx hash). */
+    txHash?: string;
+}
+interface PhoneRenewResponse {
+    phone_number: string;
+    /** Extended expiry (30 days from previous expiry). */
+    expires_at: string;
+    txHash?: string;
+}
+interface PhoneNumberRecord {
+    phone_number: string;
+    chain: string;
+    expires_at: string;
+    active: boolean;
+}
+interface PhoneListResponse {
+    numbers: PhoneNumberRecord[];
+    count: number;
+    txHash?: string;
+}
+interface PhoneReleaseResponse {
+    released: true;
+    phone_number: string;
+    txHash?: string;
+}
+interface BlockrunClientOptions {
+    privateKey?: `0x${string}` | string;
+    apiUrl?: string;
+    /** Per-HTTP-call timeout in ms (default 60000). For long-running poll() jobs,
+     *  set budgetMs in PollOptions instead — this only bounds individual fetches. */
+    timeout?: number;
+}
+interface PollOptions {
+    /** Total wall-clock budget for the entire submit + poll loop (default 300000 = 5 min). */
+    budgetMs?: number;
+    /** Sleep between poll attempts (default 5000 = 5 s). */
+    intervalMs?: number;
+}
 declare class BlockrunError extends Error {
     constructor(message: string);
 }
@@ -1584,6 +1674,106 @@ declare class VoiceClient {
     getSpending(): Spending;
 }
 
+/**
+ * BlockRun Phone Client — Twilio-backed phone lookup + number provisioning via x402.
+ *
+ * Endpoints (all under /v1/phone/...):
+ *   POST /lookup            $0.01    Carrier + line-type lookup
+ *   POST /lookup/fraud      $0.05    Carrier + SIM-swap / call-forwarding signals
+ *   POST /numbers/buy       $5.00    Provision a US/CA number (30-day lease, bound to wallet)
+ *   POST /numbers/renew     $5.00    Extend an existing number by 30 days
+ *   POST /numbers/list      $0.001   List the wallet's active numbers
+ *   POST /numbers/release   free     Release a provisioned number (still flows through x402
+ *                                    so the backend can verify wallet identity)
+ *
+ * After buying a number you can use it as the `from` caller ID in VoiceClient.call().
+ *
+ * SECURITY NOTE — your private key never leaves your machine. Only EIP-712
+ * signatures are sent in the PAYMENT-SIGNATURE header.
+ *
+ * @example
+ *   import { PhoneClient } from '@blockrun/llm';
+ *
+ *   const client = new PhoneClient({ privateKey: '0x...' });
+ *
+ *   // Lookup a number
+ *   const info = await client.lookup('+14155552671');
+ *
+ *   // Buy a number (US, optional area code)
+ *   const bought = await client.buyNumber({ country: 'US', areaCode: '415' });
+ *   console.log(bought.phone_number, bought.expires_at);
+ *
+ *   // List your active numbers
+ *   console.log(await client.listNumbers());
+ *
+ *   // Renew / release
+ *   await client.renewNumber(bought.phone_number);
+ *   await client.releaseNumber(bought.phone_number);
+ */
+
+/** Per-endpoint price in USD — mirrors the backend's `PHONE_PRICES`. */
+declare const PHONE_PRICES: Readonly<Record<string, number>>;
+/**
+ * BlockRun Phone Client.
+ *
+ * Wraps the `/v1/phone/*` x402 endpoints — phone-number lookup (carrier + fraud)
+ * and provisioning of the caller-ID numbers required by VoiceClient.call().
+ */
+declare class PhoneClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: PhoneClientOptions);
+    /** EVM wallet address used for payments. */
+    getWalletAddress(): string;
+    /** Session-cumulative USD spend + call count across this client instance. */
+    getSpending(): Spending;
+    /**
+     * Carrier + line-type lookup. ~$0.01.
+     *
+     * @param phoneNumber E.164 number (e.g. "+14155552671").
+     */
+    lookup(phoneNumber: string): Promise<PhoneLookupResponse>;
+    /**
+     * Lookup + fraud signals (SIM swap, call forwarding). ~$0.05.
+     *
+     * @param phoneNumber E.164 number.
+     */
+    lookupFraud(phoneNumber: string): Promise<PhoneLookupResponse>;
+    /**
+     * Provision a dedicated phone number for 30 days. $5.00.
+     *
+     * Payment is settled only after Twilio confirms the purchase, so failed
+     * buys never charge your wallet.
+     *
+     * @param options.country  ISO country code, "US" or "CA" (default "US").
+     * @param options.areaCode Optional 3-digit area-code hint. Availability is
+     *   not guaranteed — the backend falls back to any number in the country if
+     *   the area code can't be matched.
+     */
+    buyNumber(options?: PhoneBuyOptions): Promise<PhoneBuyResponse>;
+    /**
+     * Extend an existing provisioned number by 30 days. $5.00.
+     *
+     * @throws {APIError} 403 when the wallet doesn't own the number or it has expired.
+     */
+    renewNumber(phoneNumber: string): Promise<PhoneRenewResponse>;
+    /** List the wallet's active phone numbers. ~$0.001. */
+    listNumbers(): Promise<PhoneListResponse>;
+    /**
+     * Release a provisioned number back to the Twilio pool. Free, but still
+     * flows through x402 so the backend can verify ownership.
+     */
+    releaseNumber(phoneNumber: string): Promise<PhoneReleaseResponse>;
+    private request;
+    private handlePaymentAndRetry;
+    private unwrap;
+    private fetchWithTimeout;
+}
+
 /**
  * BlockRun Search Client - Standalone Grok Live Search via x402 micropayments.
  *
@@ -1760,8 +1950,8 @@ declare class PriceClient {
  *   const typed = await surf.get<Price>("/market/price", { symbol: "ETH" });
  */
 
-type QueryValue = string | number | boolean | null | undefined;
-type QueryParams = Record<string, QueryValue | QueryValue[]>;
+type QueryValue$1 = string | number | boolean | null | undefined;
+type QueryParams$1 = Record<string, QueryValue$1 | QueryValue$1[]>;
 declare class SurfClient {
     private account;
     private privateKey;
@@ -1773,7 +1963,7 @@ declare class SurfClient {
      * `/v1/surf` is tolerated and stripped). Query params are URL-encoded;
      * arrays become repeated keys (`?a=1&a=2`).
      */
-    get<T = unknown>(path: string, params?: QueryParams): Promise<T>;
+    get<T = unknown>(path: string, params?: QueryParams$1): Promise<T>;
     /**
      * POST a Surf endpoint with a JSON body. Same path normalization as `get`.
      */
@@ -1786,6 +1976,130 @@ declare class SurfClient {
     getWalletAddress(): string;
 }
 
+/**
+ * BlockrunClient — the x402-paying HTTP primitive for the BlockRun gateway.
+ *
+ * This is the **primitive** that every BlockRun API surface composes on top of:
+ * a wallet, an x402 401-sign-replay handler, and four call shapes (get, post,
+ * poll, stream). Per-API classes (LLMClient, ImageClient, SurfClient, …) are
+ * being collapsed into Claude Code skills that drive this client directly.
+ *
+ * Why one primitive instead of one client per API surface:
+ *   - Every BlockRun endpoint pays the same way (USDC via x402 on Base/Solana)
+ *   - ~30-40 % of each existing client class is identical boilerplate
+ *   - New API surfaces should ship as a skill (markdown) + path, not as a
+ *     new TypeScript class + npm release
+ *
+ * Four call shapes:
+ *   client.get<T>(path, params?)                — sync GET, e.g. /v1/surf/market/price
+ *   client.post<T>(path, body?)                 — sync POST, e.g. /v1/surf/onchain/sql
+ *   client.poll<T>(path, body?, { budgetMs })   — submit + poll, e.g. /v1/videos/generations
+ *   client.stream<T>(path, body?)               — SSE iterator, e.g. /v1/chat/completions
+ *
+ * Usage:
+ *   import { BlockrunClient } from "@blockrun/llm";
+ *
+ *   const br = new BlockrunClient({ privateKey: "0x..." });
+ *
+ *   // Surf endpoint (Tier 1, $0.001)
+ *   const btc = await br.get("/v1/surf/market/price", { symbol: "BTC" });
+ *
+ *   // Raw on-chain SQL (Tier 3, $0.020)
+ *   const rows = await br.post("/v1/surf/onchain/sql", {
+ *     query: "SELECT block_number FROM ethereum.blocks ORDER BY block_number DESC LIMIT 1",
+ *   });
+ *
+ *   // Long-running video generation (submit + poll, paid on success)
+ *   const video = await br.poll("/v1/videos/generations", {
+ *     model: "xai/grok-imagine-video",
+ *     prompt: "a red apple spinning",
+ *   });
+ *
+ *   // Streaming chat
+ *   for await (const chunk of br.stream("/v1/chat/completions", {
+ *     model: "anthropic/claude-sonnet-4-6",
+ *     messages: [{ role: "user", content: "Hi" }],
+ *     stream: true,
+ *   })) {
+ *     process.stdout.write(chunk.choices?.[0]?.delta?.content ?? "");
+ *   }
+ */
+
+type QueryValue = string | number | boolean | null | undefined;
+type QueryParams = Record<string, QueryValue | QueryValue[]>;
+/**
+ * The x402-paying HTTP primitive for the BlockRun gateway.
+ *
+ * One instance, one wallet, all endpoints. The four call shapes (get, post,
+ * poll, stream) cover every endpoint type the gateway exposes.
+ */
+declare class BlockrunClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: BlockrunClientOptions);
+    /**
+     * GET a BlockRun endpoint. `path` is everything after `/api` (a leading
+     * `/api` is tolerated and stripped). Query params are URL-encoded; arrays
+     * become repeated keys (`?a=1&a=2`); undefined/null are dropped.
+     */
+    get<T = unknown>(path: string, params?: QueryParams): Promise<T>;
+    /**
+     * POST a BlockRun endpoint with a JSON body.
+     */
+    post<T = unknown>(path: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Submit a long-running job and poll until it completes.
+     *
+     * Pattern: submit → 402 → sign → 202 `{ id, poll_url, status }` → loop GET
+     * the poll_url with the SAME `PAYMENT-SIGNATURE` until status=completed (or
+     * deadline exceeded). Settlement happens only when upstream returns 200 +
+     * completed — upstream failure or caller giving up = no charge.
+     *
+     * If the gateway returns 200 directly on submit (no async surface), this
+     * short-circuits and returns the body. Most long-running endpoints (image,
+     * video, music, voice) return 202 with a poll_url.
+     */
+    poll<T = unknown>(path: string, body?: Record<string, unknown>, options?: PollOptions): Promise<T>;
+    /**
+     * Stream a Server-Sent Events endpoint.
+     *
+     * Yields each `data: …` line parsed as JSON. Stops when the upstream emits
+     * `data: [DONE]` or closes the connection. Caller is responsible for typing
+     * the chunk shape; pass a generic for typed yields.
+     *
+     * Example — streaming chat:
+     *   for await (const chunk of br.stream<ChatChunk>("/v1/chat/completions", {
+     *     model: "anthropic/claude-sonnet-4-6",
+     *     messages: [{ role: "user", content: "Hi" }],
+     *     stream: true,
+     *   })) {
+     *     process.stdout.write(chunk.choices?.[0]?.delta?.content ?? "");
+     *   }
+     */
+    stream<T = unknown>(path: string, body?: Record<string, unknown>): AsyncGenerator<T, void, undefined>;
+    private buildUrl;
+    private absolute;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    /**
+     * Read a 402 response's payment requirements (header or body), then sign and
+     * return the base64 PAYMENT-SIGNATURE payload. Also records the cost-to-be
+     * onto the response context (settled on `recordSpending`).
+     */
+    private signFrom402;
+    /** Accumulates the most-recent pending cost; settled by recordSpending. */
+    private pendingCostUsd;
+    private recordSpending;
+    private throwApiError;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
 /**
  * x402 Payment Protocol v2 Implementation for BlockRun.
  *
@@ -1826,6 +2140,11 @@ interface CreateSolanaPaymentOptions {
     extra?: Record<string, unknown>;
     extensions?: Record<string, unknown>;
     rpcUrl?: string;
+    /**
+     * Optional HTTP headers forwarded to the Solana RPC endpoint
+     * (e.g. `{ "x-api-key": "..." }` for Tatum / header-auth gateways).
+     */
+    rpcHeaders?: Record<string, string>;
 }
 /**
  * Create a signed Solana x402 v2 payment payload.
@@ -2015,8 +2334,21 @@ interface SolanaLLMClientOptions {
     privateKey?: string;
     /** API endpoint URL (default: https://sol.blockrun.ai/api) */
     apiUrl?: string;
-    /** Solana RPC URL (default: https://api.mainnet-beta.solana.com) */
+    /**
+     * Solana JSON-RPC URL. Defaults to BlockRun's own Tatum-backed proxy
+     * (`https://sol.blockrun.ai/api/v1/solana/rpc`), free for SDK users.
+     * Override to point at your own Helius / Tatum / QuickNode account, or
+     * fall back to the env vars `SOLANA_RPC_URL` /
+     * `SOLANA_RPC_API_KEY` / `SOLANA_RPC_HEADERS`.
+     */
     rpcUrl?: string;
+    /**
+     * Optional headers forwarded to the Solana RPC endpoint. Use this for
+     * header-auth gateways (Tatum's `x-api-key`, some Triton tiers). Falls
+     * back to `SOLANA_RPC_HEADERS` (JSON dict) or `SOLANA_RPC_API_KEY`
+     * (shortcut for `{ "x-api-key": "..." }`) env vars when omitted.
+     */
+    rpcHeaders?: Record<string, string>;
     /** Request timeout in milliseconds (default: 60000) */
     timeout?: number;
 }
@@ -2025,6 +2357,7 @@ declare class SolanaLLMClient {
     private privateKey;
     private apiUrl;
     private rpcUrl;
+    private rpcHeaders?;
     private timeout;
     private sessionTotalUsd;
     private sessionCalls;
@@ -2429,4 +2762,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, 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, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PaymentError, type PaymentLinks, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, 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 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, type NewsSearchSource, OpenAI, type OpenAIChatCompletionChoice, type OpenAIChatCompletionChunk, type OpenAIChatCompletionParams, type OpenAIChatCompletionResponse, type OpenAIClientOptions, PHONE_PRICES, PaymentError, type PaymentLinks, type PhoneBuyOptions, type PhoneBuyResponse, PhoneClient, type PhoneClientOptions, type PhoneListResponse, type PhoneLookupResponse, type PhoneNumberRecord, type PhoneReleaseResponse, type PhoneRenewResponse, type PollOptions, type PriceBar, type PriceCategory, PriceClient, type PriceClientOptions, type PriceHistoryResponse, type PriceOptions, type PricePoint, type RoutingDecision, type RoutingProfile, type RoutingTier, type RssSearchSource, SOLANA_NETWORK, SOLANA_WALLET_FILE as SOLANA_WALLET_FILE_PATH, SearchClient, type SearchClientOptions, type SearchOptions, type SearchParameters, type SearchResult, type SearchSource, type SearchUsage, type SmartChatOptions, type SmartChatResponse, SolanaLLMClient, type SolanaLLMClientOptions, type SolanaWalletInfo, 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 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 };