@blockrun/llm 3.19.1 → 3.20.1

package/dist/index.d.ts

@@ -1,13 +1,5 @@
 import * as _anthropic_ai_sdk from '@anthropic-ai/sdk';
 
-/** Account billing is independent of the wallet payment chain. */
-interface ApiKeyOptions {
-    /** BlockRun account key. Defaults to BLOCKRUN_API_KEY unless a privateKey is explicit. */
-    apiKey?: string;
-}
-declare const API_KEY_URL = "https://api.blockrun.ai";
-declare const PORTAL_URL = "https://user.blockrun.ai";
-
 /**
  * Smart Router Types
  *
@@ -1180,6 +1172,33 @@ interface PollOptions {
     /** Sleep between poll attempts (default 5000 = 5 s). */
     intervalMs?: number;
 }
+/**
+ * Whether a failed request may be retried, or sent to another model, without
+ * risking a second charge. The request layer that knows whether a payment was
+ * sent attaches it to the error it throws; read it with
+ * {@link retryDisposition}.
+ *
+ * - `"unpaid"`: nothing that could be charged was sent for this request: the
+ *   unpaid first request of an x402 exchange (and its 402 challenge), the
+ *   signing step, or, with an API key, the account API's explicit 4xx
+ *   refusal. A retry or a fallback model pays at most once.
+ * - `"paid-or-in-doubt"`: a payment was sent (with an API key, the billed
+ *   request itself) and may have been charged: a timeout, an abort or a
+ *   network error after it was sent, any non-2xx answer to it, or a 2xx whose
+ *   body could not be read. A retry or a fallback model could pay twice, so
+ *   the SDK does neither.
+ *
+ * An error that carries no disposition is treated as `"paid-or-in-doubt"`.
+ */
+type RetryDisposition = "unpaid" | "paid-or-in-doubt";
+/**
+ * The {@link RetryDisposition} the SDK attached to an error, or undefined
+ * when it attached none (then treat the error as `"paid-or-in-doubt"`).
+ *
+ * @example
+ * if (retryDisposition(err) === "unpaid") await retryLater();
+ */
+declare function retryDisposition(err: unknown): RetryDisposition | undefined;
 declare class BlockrunError extends Error {
     constructor(message: string);
 }
@@ -1204,6 +1223,14 @@ declare class APIError extends BlockrunError {
     constructor(message: string, statusCode: number, response?: unknown);
 }
 
+/** Account billing is independent of the wallet payment chain. */
+interface ApiKeyOptions {
+    /** BlockRun account key. Defaults to BLOCKRUN_API_KEY unless a privateKey is explicit. */
+    apiKey?: string;
+}
+declare const API_KEY_URL = "https://api.blockrun.ai";
+declare const PORTAL_URL = "https://user.blockrun.ai";
+
 /**
  * BlockRun LLM Gateway Client.
  *
@@ -1300,10 +1327,13 @@ declare class LLMClient {
      * Full chat completion interface (OpenAI-compatible).
      *
      * When `fallbackModels` is set, transient failures (timeouts, network
-     * errors, 5xx) on the primary model trigger a retry against the next
-     * model in the list before raising. 4xx errors and PaymentError
-     * propagate immediately — those aren't "swap upstream and retry"
-     * situations. Each fallback hop logs one stderr line.
+     * errors, 429, 5xx) on the primary model trigger a retry against the next
+     * model in the list before raising, but only while no payment has been
+     * sent for it (the error's {@link RetryDisposition} is `"unpaid"`). Once a
+     * payment was sent, any failure propagates: the next model would be a
+     * second charge. 4xx errors and PaymentError also propagate immediately —
+     * those aren't "swap upstream and retry" situations. Each fallback hop
+     * logs one stderr line.
      *
      * @param model - Primary model ID
      * @param messages - Array of messages with role and content
@@ -1331,12 +1361,37 @@ declare class LLMClient {
     private parseChatResponse;
     /**
      * Make a request with automatic x402 payment handling.
+     *
+     * Every error it throws carries a {@link RetryDisposition}, which is what
+     * {@link LLMClient.chatCompletion}'s fallback walk honours: errors of the
+     * unpaid first request (and its one 502/503 retry), of the 402 challenge
+     * and of signing are `"unpaid"`; anything after the signed payment was sent
+     * is `"paid-or-in-doubt"`. With an API key the request itself is billed, so
+     * only the account API's explicit 4xx refusal is `"unpaid"`.
      */
     private requestWithPayment;
+    /**
+     * Send a request that carries no payment, marking what it throws with its
+     * {@link RetryDisposition}: `"unpaid"` with a wallet; with an API key, see
+     * {@link accountErrorDisposition} (the request itself is billed).
+     */
+    private sendUnpaid;
+    /**
+     * Parse a response to a request that carried no payment: the free tier,
+     * or, with an API key, the billed request itself.
+     */
+    private parseUnpaidChatResponse;
     /**
      * Handle 402 response: parse requirements, sign payment, retry.
+     *
+     * Anything thrown before the signed payment is sent is `"unpaid"`; anything
+     * after it, `"paid-or-in-doubt"` (see {@link RetryDisposition}).
      */
     private handlePaymentAndRetry;
+    /** Read a 402's requirements and sign the exact payment for them. Sends nothing. */
+    private signFrom402;
+    /** Send the signed payment and read the answer. The payment may settle from here on. */
+    private sendPaid;
     /**
      * Sign a payment header and return the PAYMENT-SIGNATURE value.
      * Extracted to share logic between streaming and non-streaming flows.
@@ -2727,10 +2782,13 @@ interface SolanaBatchOptions {
      */
     operators: string[];
     /**
-     * Total escrow, in USD, this client will lock in one channel (the first
-     * deposit plus every top-up). This is the most an operator could take
-     * without another signature from you. Accepts `"$5"`, `"5"` or `5`.
-     * Default `"$1"` (the `@x402/svm` default).
+     * Most escrow, in USD, this client keeps at stake in one channel: the
+     * deposit not yet settled on-chain. A top-up is allowed while
+     * `(deposit - settled) + topUp <= maxDeposit`, so a long-lived channel keeps
+     * topping up as the gateway settles what it charged. This is the most an
+     * operator could claim beyond what has already been settled without
+     * another signature from you. Accepts `"$5"`, `"5"` or `5`. Default `"$1"`
+     * (the `@x402/svm` default).
      */
     maxDeposit?: string | number;
     /**
@@ -2741,6 +2799,205 @@ interface SolanaBatchOptions {
      *   by scanning the chain for it.
      */
     channelStore?: string | false;
+    /**
+     * How a call rides out an HTTP 429 (rate limited, or channel capacity
+     * exhausted) on a batch payment before it pays with `exact`. The call waits
+     * for `Retry-After` (seconds or an HTTP date), or 1s, 2s, 4s... with jitter
+     * when there is none (or when it is not a finite delay of at most a day),
+     * then tries again: a 429 without a receipt by replaying the identical
+     * payment, one that proves nothing was broadcast with a new payment. Other
+     * calls for the same wallet wait out the same cooldown instead of sending
+     * new channel opens; that shared cooldown never lasts longer than
+     * `maxWaitMs`.
+     */
+    rateLimit?: {
+        /** Batch payment attempts per call, the first one included. Default 3. */
+        maxAttempts?: number;
+        /** Most time, in ms, one call spends waiting on 429s before it pays `exact`. Default 60000. */
+        maxWaitMs?: number;
+    };
+    /**
+     * Called for every batch fallback, 429 backoff, recovery and channel
+     * re-read, in addition to the one-line log the SDK writes to stderr for each.
+     * A callback that throws, or returns a promise that rejects, is logged and
+     * ignored; it never affects the payment, and its promise is not awaited.
+     */
+    onEvent?: (event: SolanaBatchEvent) => void | PromiseLike<void>;
+}
+/** Default {@link SolanaBatchOptions.rateLimit}. */
+declare const DEFAULT_BATCH_RATE_LIMIT: {
+    readonly maxAttempts: 3;
+    readonly maxWaitMs: 60000;
+};
+/**
+ * One observable batch-settlement event.
+ *
+ * - `fallback`: this call pays with `exact`. `reason` says why. Only ever
+ *   when no batch payment of this call can have been charged.
+ * - `backoff`: this call is waiting before it retries batch, after a 429
+ *   (`reason: "rate_limited"`) or because another call for the wallet hit one
+ *   (`reason: "cooldown"`).
+ * - `recovered`: a call that backed off was then paid with batch, or its
+ *   fresh challenge after the wait was served without a payment (`reason:
+ *   "served_unpaid_on_rechallenge"`: that response is the call's result, and
+ *   nothing was paid).
+ * - `unresolved`: this call is raised as {@link BatchPaymentUnresolvedError},
+ *   not paid with `exact` or any fallback model, because a batch payment it
+ *   sent may have been charged and got no definitive answer. `reason` is a
+ *   {@link BatchUnresolvedReason}.
+ * - `resync`: the channel was re-read from the chain because the SDK could
+ *   not trust its record (a deposit with no clean answer, including a 429
+ *   without a receipt, a receipt that was missing or rebuilt, or a pending
+ *   deposit left by a process that died).
+ *   `reason` says which; `detail` says what the chain showed.
+ */
+interface SolanaBatchEvent {
+    type: "fallback" | "backoff" | "recovered" | "resync" | "unresolved";
+    /**
+     * A short, stable code: `rate_limited`, `cooldown`, `not_offered`,
+     * `client_signed_not_supported`, `channel_busy`, `untrusted_operator`, `deposit_over_cap`,
+     * `channel_pending`, `closed_during_call`, `peer_dependency_missing`, `payment_creation_failed`,
+     * `wallet_config_conflict`, `channel_store_locked`, `payment_required`,
+     * `channel_resync_pending`, `channel_resync_failed`, `channel_unreadable`,
+     * `deposit_journal_unreadable`, `deposit_journal_failed`,
+     * `served_unpaid_on_rechallenge` or `batch_cancelled` (`recovered` events), or one of the gateway's refusal codes the
+     * SDK recognises (`batch_payer_not_allowed`, `batch_payer_not_admitted`,
+     * `batch_admission_paused`, `batch_server_signed_only`, `batch_unavailable`,
+     * `batch_channel_limit`, `PAYMENT_VERIFICATION_UNAVAILABLE`). An `unresolved` event's reason is a
+     * {@link BatchUnresolvedReason}. A `resync` event's reason is
+     * `deposit_unanswered`, `deposit_failed`, `deposit_rate_limited`,
+     * `deposit_refused`, `receipt_missing`, `receipt_unreconciled`,
+     * `orphaned_deposit`, `deposit_unrecorded` or `channel_unusable`.
+     */
+    reason: string;
+    /** HTTP status of the gateway answer behind the event, when there was one. */
+    status?: number;
+    /** The gateway's or facilitator's error code, when it named one. */
+    errorReason?: string;
+    /** How long this call waits (backoff), or would have had to wait (fallback). */
+    retryAfterMs?: number;
+    /** Which batch payment attempt of this call the event belongs to (1-based). */
+    attempt?: number;
+    /** Free-text detail, such as the underlying error message. */
+    detail?: string;
+    /** The paying wallet's address. */
+    wallet: string;
+    /** When it happened, in ms since the epoch. */
+    at: number;
+}
+/** Batch-settlement counters for one client, from {@link SolanaLLMClient.getBatchStats}. */
+interface SolanaBatchStats {
+    /** Calls that paid with `exact` instead of batch. */
+    fallbacks: number;
+    /** {@link fallbacks}, split by {@link SolanaBatchEvent.reason}. */
+    fallbacksByReason: Record<string, number>;
+    /** Waits before a batch retry (own 429s and shared cooldowns). */
+    backoffs: number;
+    /** Batch payments sent again after a 429: a new payment, or the one replay of a receipt-less 429. */
+    retries: number;
+    /**
+     * Calls paid with batch after at least one backoff, or served without a
+     * payment by their fresh challenge after one (`served_unpaid_on_rechallenge`).
+     */
+    recoveries: number;
+    /** Times the channel record was re-read from the chain. */
+    resyncs: number;
+    /**
+     * Calls raised as {@link BatchPaymentUnresolvedError}: a batch payment they
+     * sent may have been charged, so nothing paid for them again.
+     */
+    unresolved: number;
+    /** {@link unresolved}, split by {@link BatchUnresolvedReason}. */
+    unresolvedByReason: Record<string, number>;
+}
+/**
+ * Why a batch payment is left in doubt; see {@link BatchPaymentUnresolvedError}.
+ *
+ * - `replay_unresolved`: a 429 without a receipt. Its one byte-identical
+ *   replay got no definitive success receipt (a 402, `duplicate_settlement`,
+ *   another 429, a 5xx, a timeout...), or `batch.rateLimit` left no room to
+ *   replay it.
+ * - `ambiguous_rate_limit`: a 429 whose receipt does not prove nothing was
+ *   broadcast (one that says it was charged, `settlement_pending`, or one
+ *   naming a transaction).
+ * - `no_response`: sending it threw (a timeout, an abort, a network error),
+ *   whatever the error's code: the request may have reached the gateway.
+ * - `outcome_unknown`: any other answer that neither serves the call nor
+ *   proves nothing was charged: a 5xx without a recognised refusal code, an
+ *   unrecognised 4xx, or a non-2xx whose receipt names a transaction, says
+ *   `settlement_pending`, or says it succeeded.
+ * - `duplicate_settlement`: the first answer was a 402 naming
+ *   `duplicate_settlement`: the gateway had already reserved this request id,
+ *   so another copy of the payment reached it and may have been charged.
+ */
+type BatchUnresolvedReason = "replay_unresolved" | "ambiguous_rate_limit" | "no_response" | "outcome_unknown" | "duplicate_settlement";
+/** What a batch payment carried: a channel open, a top-up of the channel, or an authorization alone. */
+type BatchPayloadKind = "open" | "top-up" | "authorization";
+/**
+ * A batch payment this call sent may have been charged, and never got a
+ * definitive answer. Reported as an `unresolved` event with the same
+ * `reason` (see {@link BatchUnresolvedReason}).
+ *
+ * A {@link PaymentError} whose {@link RetryDisposition} is
+ * `"paid-or-in-doubt"`, never transient: the SDK does not pay for the call
+ * again, not with `exact`, not with a new batch payment, and not by moving
+ * on to `fallbackModels` (including the chain `smartChat()` fills in). Any
+ * retry is yours to make, and it is a new payment.
+ *
+ * When it carried a deposit (`payloadKind` `open` or `top-up`), the deposit
+ * is in doubt too: the SDK signs no other deposit for that wallet's channels
+ * until a chain read at `finalized` commitment settles it.
+ */
+declare class BatchPaymentUnresolvedError extends PaymentError {
+    /** The {@link SolanaBatchEvent.reason} of the `unresolved` event reported with it. */
+    readonly reason: BatchUnresolvedReason;
+    /** The paying wallet's address. */
+    readonly wallet: string;
+    /** The request id of the payment that may have been charged. */
+    readonly requestId?: string;
+    /** The channel it paid into. */
+    readonly channelId?: string;
+    /** What it carried. */
+    readonly payloadKind?: BatchPayloadKind;
+    /** HTTP status of the gateway's last answer to it, when there was one. */
+    readonly status?: number;
+    /** Whether it carried a deposit, which is now in doubt as well. */
+    readonly depositInDoubt: boolean;
+    constructor(init: {
+        reason: BatchUnresolvedReason;
+        wallet: string;
+        requestId?: string;
+        channelId?: string;
+        payloadKind?: BatchPayloadKind;
+        status?: number;
+        detail?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * `closeBatchChannel()` did not close anything, and should be called again
+ * later:
+ * - `call_in_flight`: a batch call for the wallet is still running (it may
+ *   be waiting out a 429 before its retry or replay);
+ * - `deposit_in_doubt`: a deposit the wallet sent (an open or top-up) has
+ *   not been settled yet. It settles once a `finalized` chain read shows it
+ *   landed, or once the finalized chain is past its last valid block,
+ *   usually a few minutes after it was sent.
+ *
+ * Not a payment error: nothing was sent.
+ */
+declare class BatchCloseDeferredError extends BlockrunError {
+    readonly reason: "call_in_flight" | "deposit_in_doubt";
+    /** The paying wallet's address. */
+    readonly wallet: string;
+    /** The channels whose deposit is in doubt (`deposit_in_doubt`). */
+    readonly channelIds: string[];
+    constructor(init: {
+        reason: "call_in_flight" | "deposit_in_doubt";
+        wallet: string;
+        channelIds?: string[];
+        detail: string;
+    });
 }
 
 interface SolanaLLMClientOptions extends ApiKeyOptions {
@@ -2794,11 +3051,28 @@ declare class SolanaLLMClient {
     /**
      * Close this wallet's batch-settlement channel and return its unused escrow.
      *
-     * The gateway closes it cooperatively when it can; otherwise this starts a
-     * payer-forced close and the escrow comes back after the channel's grace
-     * period. Only meaningful with the `batch` option.
+     * Closes the channel for the operator the gateway's current 402 names; a
+     * channel opened with another trusted operator key (during a key rotation)
+     * keeps its record. The gateway closes it cooperatively when it can;
+     * otherwise this starts a payer-forced close and the escrow comes back
+     * after the channel's grace period. Only meaningful with the `batch`
+     * option.
+     *
+     * @throws BatchCloseDeferredError, closing nothing, while a chat call for
+     *   this wallet is still in flight (including one waiting out a 429, so a
+     *   retry can never reopen a channel you just closed), or while one of its
+     *   deposits is in doubt (until a `finalized` chain read shows it landed or
+     *   that it no longer can, usually a few minutes after it was sent). Call
+     *   it again later.
      */
     closeBatchChannel(): Promise<unknown>;
+    /**
+     * This client's batch-settlement counters: calls that fell back to `exact`
+     * (in total and by reason), 429 backoffs, batch retries, and recoveries.
+     * Every one of those is also logged to stderr and passed to `batch.onEvent`.
+     * Only meaningful with the `batch` option.
+     */
+    getBatchStats(): SolanaBatchStats;
     /** Get Solana wallet address (public key in base58). */
     getWalletAddress(): Promise<string>;
     /** Simple 1-line chat. */
@@ -3008,7 +3282,30 @@ declare class SolanaLLMClient {
     getSpending(): Spending;
     /** True if using sol.blockrun.ai. */
     isSolana(): boolean;
+    /**
+     * Chat request with automatic x402 payment.
+     *
+     * Every error it throws carries a {@link RetryDisposition}, which is what
+     * {@link SolanaLLMClient.chatCompletion}'s fallback walk honours: errors of
+     * the unpaid first request, its 402 challenge and the signing step are
+     * `"unpaid"`; anything after a payment was sent (exact or batch) is
+     * `"paid-or-in-doubt"`, and so is any error with an API key once the billed
+     * request was sent, except the account API's explicit 4xx refusal.
+     */
     private requestWithPayment;
+    /**
+     * Read the JSON body of a 2xx served without a payment: the free tier, or
+     * with an API key, where this very request was the billed one.
+     */
+    private readUnpaidJson;
+    /**
+     * Send a request that carries no payment, marking what it throws with its
+     * {@link RetryDisposition}: `"unpaid"` with a wallet; with an API key, see
+     * {@link accountErrorDisposition} (the request itself is billed).
+     */
+    private sendUnpaid;
+    /** Read a paid 2xx response's JSON body. The call was charged, so a failure here is never retried. */
+    private readPaidJson;
     /**
      * Turn a `402` into a signed Solana payment payload.
      *
@@ -3069,7 +3366,8 @@ declare class SolanaLLMClient {
      * lives.
      * @param response - the reply to the paid request.
      * @throws SafeStaleBlockhashError when the caller should re-sign, PaymentError
-     *   when it should not, APIError for any other failure.
+     *   when it should not, APIError for any other failure. Every one but the
+     *   first is marked `"paid-or-in-doubt"`: the payment may have settled.
      */
     private assertPaid;
     /** Count one settled x402 payment against the session total. */
@@ -3435,4 +3733,4 @@ declare function validateTemperature(temperature?: number): void;
  */
 declare function validateTopP(topP?: number): void;
 
-export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, type AudioModel, type AudioTrack, BASE_CHAIN_ID, BLOCKRUN_SOL_OPERATOR, 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, EVM_NETWORKS, type EvmNetwork, 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, PORTAL_URL, 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, type SolanaBatchOptions, 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_ARC, 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, evmNetwork, 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, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };
+export { APIError, API_KEY_URL, ARC_CHAIN_ID, AnthropicClient, type ApiKeyOptions, type AudioModel, type AudioTrack, BASE_CHAIN_ID, BLOCKRUN_SOL_OPERATOR, type BarResolution, BatchCloseDeferredError, type BatchPayloadKind, BatchPaymentUnresolvedError, type BatchUnresolvedReason, 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, DEFAULT_BATCH_RATE_LIMIT, EVM_NETWORKS, type EvmNetwork, 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, PORTAL_URL, 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 RetryDisposition, 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, type SolanaBatchEvent, type SolanaBatchOptions, type SolanaBatchStats, 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_ARC, 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, evmNetwork, extractPaymentDetails, formatFundingMessageCompact, formatNeedsFundingMessage, formatSolanaWalletMigrationNotice, formatWalletCreatedMessage, formatWalletMigrationNotice, getCached, getCachedByRequest, getCostLogSummary, getCostSummary, getEip681Uri, getOrCreateSolanaWallet, getOrCreateWallet, getPaymentLinks, getWalletAddress, importSolanaWallet, importWallet, listDiscoveredSolanaWallets, listDiscoveredWallets, loadSolanaWallet, loadWallet, logCost, parsePaymentRequired, retryDisposition, saveSolanaWallet, saveToCache, saveWallet, scanSolanaWallets, scanWallets, setCache, setupAgentClient, setupAgentSolanaWallet, setupAgentWallet, solanaClient, solanaKeyToBytes, solanaPublicKey, status, validateMaxTokens, validateModel, validateTemperature, validateTopP };