@blockrun/llm 2.1.0 → 2.2.0

package/dist/index.d.cts

@@ -291,7 +291,7 @@ interface ChatCompletionOptions {
      */
     fallbackModels?: string[];
 }
-type RoutingProfile = "free" | "eco" | "auto" | "premium";
+type RoutingProfile = "eco" | "auto" | "premium";
 type RoutingTier = "SIMPLE" | "MEDIUM" | "COMPLEX" | "REASONING";
 interface RoutingDecision {
     model: string;
@@ -302,6 +302,10 @@ interface RoutingDecision {
     costEstimate: number;
     baselineCost: number;
     savings: number;
+    /** Routing profile applied by clawrouter (may include "agentic" on gateway responses). */
+    profile?: RoutingProfile | "agentic";
+    /** Score used when agentic routing is active. */
+    agenticScore?: number;
     /**
      * Remaining tier models with known pricing, in fallback order. `chat()`
      * walks this list when the primary model hits a transient error
@@ -310,7 +314,7 @@ interface RoutingDecision {
     fallbacks?: string[];
 }
 interface SmartChatOptions extends ChatOptions {
-    /** Routing profile: free (zero cost), eco (budget), auto (balanced), premium (best quality) */
+    /** Routing profile: eco (budget), auto (balanced), premium (best quality) */
     routingProfile?: RoutingProfile;
     /** Maximum output tokens (used for cost estimation) */
     maxOutputTokens?: number;
@@ -379,6 +383,74 @@ interface MusicGenerateOptions {
     /** Custom lyrics — cannot be used with instrumental: true */
     lyrics?: string;
 }
+/** Built-in Bland.ai voice presets. Any string is accepted (custom voice IDs work too). */
+type VoicePreset = "nat" | "josh" | "maya" | "june" | "paige" | "derek" | "florian";
+/** Bland.ai conversation model tier. */
+type CallModel = "base" | "enhanced" | "turbo";
+interface VoiceClientOptions {
+    /** 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 — initiation only) */
+    timeout?: number;
+}
+interface CallOptions {
+    /** Destination phone number in E.164 format (e.g. "+14155552671"). US + Canada. */
+    to: string;
+    /** What the AI agent should do on the call. 10–4000 chars. */
+    task: string;
+    /** Your provisioned BlockRun caller-ID number (E.164). Must be wallet-owned. */
+    from?: string;
+    /** Voice preset or any Bland.ai voice ID. */
+    voice?: VoicePreset | string;
+    /** Maximum call length in minutes (1–30, default 5). */
+    max_duration?: number;
+    /** BCP-47 language code for STT/TTS (default "en-US"). */
+    language?: string;
+    /** Optional opening line spoken by the agent. */
+    first_sentence?: string;
+    /** If true, wait for the recipient to speak first. */
+    wait_for_greeting?: boolean;
+    /** Sensitivity for detecting recipient interruption (50–500 ms). */
+    interruption_threshold?: number;
+    /** Conversation model. */
+    model?: CallModel;
+}
+interface CallInitiatedResponse {
+    call_id: string;
+    status: string;
+    poll_url: string;
+    message?: string;
+    /** On-chain payment receipt (Base tx hash). */
+    txHash?: string;
+}
+/**
+ * Bland.ai call status payload. Returned from getStatus.
+ * Most fields are populated only after the call ends.
+ */
+interface CallStatusResponse {
+    call_id?: string;
+    status?: string;
+    to?: string;
+    from?: string;
+    /** ISO timestamp call started, or null while queued. */
+    started_at?: string | null;
+    /** ISO timestamp call ended, or null while in progress. */
+    ended_at?: string | null;
+    /** Total call length in seconds, once completed. */
+    call_length?: number;
+    /** URL to the call recording (mp3/wav). */
+    recording_url?: string | null;
+    /** Full text transcript of the call. */
+    concatenated_transcript?: string | null;
+    /** Per-turn transcript array. Shape comes from Bland.ai. */
+    transcripts?: Array<Record<string, unknown>>;
+    /** Why the call ended ("user_hangup", "agent_hangup", "timeout", …). */
+    ended_reason?: string | null;
+    /** Pass-through for anything Bland.ai adds. */
+    [key: string]: unknown;
+}
 interface VideoClip {
     /** Permanent blockrun-hosted URL (falls back to upstream if backup fails) */
     url: string;
@@ -781,9 +853,6 @@ declare class LLMClient {
      *
      * @example With routing profile
      * ```ts
-     * // Free tier only (zero cost)
-     * const result = await client.smartChat('Hello!', { routingProfile: 'free' });
-     *
      * // Eco mode (budget optimized)
      * const result = await client.smartChat('Explain quantum computing', { routingProfile: 'eco' });
      *
@@ -1353,6 +1422,145 @@ declare class MusicClient {
     getSpending(): Spending;
 }
 
+/**
+ * BlockRun Video Client - Generate short AI videos via x402 micropayments.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Async flow (client-polled):
+ *   POST /v1/videos/generations         -> 402 -> sign -> 202 { id, poll_url }
+ *   GET  /v1/videos/generations/{id}    -> loop until status=completed
+ *
+ * The client signs ONCE and replays the same PAYMENT-SIGNATURE on every poll.
+ * Settlement happens only on the first completed poll, so upstream failure or
+ * the caller giving up = zero charge.
+ *
+ * Usage:
+ *   import { VideoClient } from '@blockrun/llm';
+ *
+ *   const client = new VideoClient({ privateKey: '0x...' });
+ *   const result = await client.generate('a red apple slowly spinning on a wooden table');
+ *   console.log(result.data[0].url);            // permanent MP4 URL
+ *   console.log(result.data[0].duration_seconds);
+ */
+
+/**
+ * BlockRun Video Generation Client.
+ *
+ * Supports xAI Grok Imagine Video and ByteDance Seedance (1.5 Pro /
+ * 2.0 Fast / 2.0 Pro) with automatic x402 micropayments on Base.
+ */
+declare class VideoClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: VideoClientOptions);
+    /**
+     * Generate a short video clip from a text prompt (or text + image).
+     *
+     * Submits an async job, then polls until the video is ready. Typical total
+     * wall-time is 60-180s. If upstream runs past the budget (default 5min),
+     * throws without charging.
+     *
+     * @param prompt - Text description of the video
+     * @param options - Optional generation parameters
+     */
+    generate(prompt: string, options?: VideoGenerateOptions & {
+        budgetMs?: number;
+    }): Promise<VideoResponse>;
+    private submitAndPoll;
+    private absolute;
+    private extractPaymentRequired;
+    private throwApiError;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
+/**
+ * BlockRun Voice Call Client - AI-powered outbound phone calls via x402 micropayments.
+ *
+ * The AI agent calls a phone number (E.164) and conducts a real-time conversation
+ * based on your 'task' instructions. STT, LLM, and TTS are handled upstream by
+ * Bland.ai; BlockRun handles billing through x402.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Usage:
+ *   import { VoiceClient } from '@blockrun/llm';
+ *
+ *   const client = new VoiceClient({ privateKey: '0x...' });
+ *
+ *   // Initiate a call (paid, $0.54)
+ *   const result = await client.call({
+ *     to: '+14155552671',
+ *     task: 'You are a friendly assistant calling to confirm a 3pm dentist appointment.',
+ *     max_duration: 5,
+ *   });
+ *   console.log(result.call_id);
+ *
+ *   // Poll status, transcript, recording (free)
+ *   const status = await client.getStatus(result.call_id);
+ *   console.log(status);
+ */
+
+/**
+ * BlockRun Voice Call Client.
+ *
+ * Initiates AI-powered outbound phone calls with automatic x402 micropayments
+ * on Base chain.
+ *
+ * Pricing: $0.54 per call (regardless of duration up to max_duration).
+ * Status polling is free.
+ */
+declare class VoiceClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: VoiceClientOptions);
+    /**
+     * Initiate an AI-powered outbound phone call.
+     *
+     * Pricing: $0.54 per call. Returns immediately once the call is queued —
+     * poll getStatus() for transcript and recording.
+     *
+     * @example
+     *   const r = await client.call({
+     *     to: '+14155552671',
+     *     task: 'Confirm the user wants to reschedule to Tuesday 2pm.',
+     *     voice: 'maya',
+     *     max_duration: 3,
+     *   });
+     */
+    call(options: CallOptions): Promise<CallInitiatedResponse>;
+    /**
+     * Poll the status of an in-progress or completed call. Free — no payment.
+     *
+     * Returns Bland.ai's full call record: status, transcript, recording URL, etc.
+     * Most fields populate only once the call ends.
+     */
+    getStatus(callId: string): Promise<CallStatusResponse>;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
 /**
  * BlockRun Search Client - Standalone Grok Live Search via x402 micropayments.
  *
@@ -2130,4 +2338,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 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, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, 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, 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, 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 };

package/dist/index.d.ts

@@ -291,7 +291,7 @@ interface ChatCompletionOptions {
      */
     fallbackModels?: string[];
 }
-type RoutingProfile = "free" | "eco" | "auto" | "premium";
+type RoutingProfile = "eco" | "auto" | "premium";
 type RoutingTier = "SIMPLE" | "MEDIUM" | "COMPLEX" | "REASONING";
 interface RoutingDecision {
     model: string;
@@ -302,6 +302,10 @@ interface RoutingDecision {
     costEstimate: number;
     baselineCost: number;
     savings: number;
+    /** Routing profile applied by clawrouter (may include "agentic" on gateway responses). */
+    profile?: RoutingProfile | "agentic";
+    /** Score used when agentic routing is active. */
+    agenticScore?: number;
     /**
      * Remaining tier models with known pricing, in fallback order. `chat()`
      * walks this list when the primary model hits a transient error
@@ -310,7 +314,7 @@ interface RoutingDecision {
     fallbacks?: string[];
 }
 interface SmartChatOptions extends ChatOptions {
-    /** Routing profile: free (zero cost), eco (budget), auto (balanced), premium (best quality) */
+    /** Routing profile: eco (budget), auto (balanced), premium (best quality) */
     routingProfile?: RoutingProfile;
     /** Maximum output tokens (used for cost estimation) */
     maxOutputTokens?: number;
@@ -379,6 +383,74 @@ interface MusicGenerateOptions {
     /** Custom lyrics — cannot be used with instrumental: true */
     lyrics?: string;
 }
+/** Built-in Bland.ai voice presets. Any string is accepted (custom voice IDs work too). */
+type VoicePreset = "nat" | "josh" | "maya" | "june" | "paige" | "derek" | "florian";
+/** Bland.ai conversation model tier. */
+type CallModel = "base" | "enhanced" | "turbo";
+interface VoiceClientOptions {
+    /** 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 — initiation only) */
+    timeout?: number;
+}
+interface CallOptions {
+    /** Destination phone number in E.164 format (e.g. "+14155552671"). US + Canada. */
+    to: string;
+    /** What the AI agent should do on the call. 10–4000 chars. */
+    task: string;
+    /** Your provisioned BlockRun caller-ID number (E.164). Must be wallet-owned. */
+    from?: string;
+    /** Voice preset or any Bland.ai voice ID. */
+    voice?: VoicePreset | string;
+    /** Maximum call length in minutes (1–30, default 5). */
+    max_duration?: number;
+    /** BCP-47 language code for STT/TTS (default "en-US"). */
+    language?: string;
+    /** Optional opening line spoken by the agent. */
+    first_sentence?: string;
+    /** If true, wait for the recipient to speak first. */
+    wait_for_greeting?: boolean;
+    /** Sensitivity for detecting recipient interruption (50–500 ms). */
+    interruption_threshold?: number;
+    /** Conversation model. */
+    model?: CallModel;
+}
+interface CallInitiatedResponse {
+    call_id: string;
+    status: string;
+    poll_url: string;
+    message?: string;
+    /** On-chain payment receipt (Base tx hash). */
+    txHash?: string;
+}
+/**
+ * Bland.ai call status payload. Returned from getStatus.
+ * Most fields are populated only after the call ends.
+ */
+interface CallStatusResponse {
+    call_id?: string;
+    status?: string;
+    to?: string;
+    from?: string;
+    /** ISO timestamp call started, or null while queued. */
+    started_at?: string | null;
+    /** ISO timestamp call ended, or null while in progress. */
+    ended_at?: string | null;
+    /** Total call length in seconds, once completed. */
+    call_length?: number;
+    /** URL to the call recording (mp3/wav). */
+    recording_url?: string | null;
+    /** Full text transcript of the call. */
+    concatenated_transcript?: string | null;
+    /** Per-turn transcript array. Shape comes from Bland.ai. */
+    transcripts?: Array<Record<string, unknown>>;
+    /** Why the call ended ("user_hangup", "agent_hangup", "timeout", …). */
+    ended_reason?: string | null;
+    /** Pass-through for anything Bland.ai adds. */
+    [key: string]: unknown;
+}
 interface VideoClip {
     /** Permanent blockrun-hosted URL (falls back to upstream if backup fails) */
     url: string;
@@ -781,9 +853,6 @@ declare class LLMClient {
      *
      * @example With routing profile
      * ```ts
-     * // Free tier only (zero cost)
-     * const result = await client.smartChat('Hello!', { routingProfile: 'free' });
-     *
      * // Eco mode (budget optimized)
      * const result = await client.smartChat('Explain quantum computing', { routingProfile: 'eco' });
      *
@@ -1353,6 +1422,145 @@ declare class MusicClient {
     getSpending(): Spending;
 }
 
+/**
+ * BlockRun Video Client - Generate short AI videos via x402 micropayments.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Async flow (client-polled):
+ *   POST /v1/videos/generations         -> 402 -> sign -> 202 { id, poll_url }
+ *   GET  /v1/videos/generations/{id}    -> loop until status=completed
+ *
+ * The client signs ONCE and replays the same PAYMENT-SIGNATURE on every poll.
+ * Settlement happens only on the first completed poll, so upstream failure or
+ * the caller giving up = zero charge.
+ *
+ * Usage:
+ *   import { VideoClient } from '@blockrun/llm';
+ *
+ *   const client = new VideoClient({ privateKey: '0x...' });
+ *   const result = await client.generate('a red apple slowly spinning on a wooden table');
+ *   console.log(result.data[0].url);            // permanent MP4 URL
+ *   console.log(result.data[0].duration_seconds);
+ */
+
+/**
+ * BlockRun Video Generation Client.
+ *
+ * Supports xAI Grok Imagine Video and ByteDance Seedance (1.5 Pro /
+ * 2.0 Fast / 2.0 Pro) with automatic x402 micropayments on Base.
+ */
+declare class VideoClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: VideoClientOptions);
+    /**
+     * Generate a short video clip from a text prompt (or text + image).
+     *
+     * Submits an async job, then polls until the video is ready. Typical total
+     * wall-time is 60-180s. If upstream runs past the budget (default 5min),
+     * throws without charging.
+     *
+     * @param prompt - Text description of the video
+     * @param options - Optional generation parameters
+     */
+    generate(prompt: string, options?: VideoGenerateOptions & {
+        budgetMs?: number;
+    }): Promise<VideoResponse>;
+    private submitAndPoll;
+    private absolute;
+    private extractPaymentRequired;
+    private throwApiError;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
+/**
+ * BlockRun Voice Call Client - AI-powered outbound phone calls via x402 micropayments.
+ *
+ * The AI agent calls a phone number (E.164) and conducts a real-time conversation
+ * based on your 'task' instructions. STT, LLM, and TTS are handled upstream by
+ * Bland.ai; BlockRun handles billing through x402.
+ *
+ * SECURITY NOTE - Private Key Handling:
+ * Your private key NEVER leaves your machine. Here's what happens:
+ * 1. Key stays local - only used to sign an EIP-712 typed data message
+ * 2. Only the SIGNATURE is sent in the PAYMENT-SIGNATURE header
+ * 3. BlockRun verifies the signature on-chain via Coinbase CDP facilitator
+ *
+ * Usage:
+ *   import { VoiceClient } from '@blockrun/llm';
+ *
+ *   const client = new VoiceClient({ privateKey: '0x...' });
+ *
+ *   // Initiate a call (paid, $0.54)
+ *   const result = await client.call({
+ *     to: '+14155552671',
+ *     task: 'You are a friendly assistant calling to confirm a 3pm dentist appointment.',
+ *     max_duration: 5,
+ *   });
+ *   console.log(result.call_id);
+ *
+ *   // Poll status, transcript, recording (free)
+ *   const status = await client.getStatus(result.call_id);
+ *   console.log(status);
+ */
+
+/**
+ * BlockRun Voice Call Client.
+ *
+ * Initiates AI-powered outbound phone calls with automatic x402 micropayments
+ * on Base chain.
+ *
+ * Pricing: $0.54 per call (regardless of duration up to max_duration).
+ * Status polling is free.
+ */
+declare class VoiceClient {
+    private account;
+    private privateKey;
+    private apiUrl;
+    private timeout;
+    private sessionTotalUsd;
+    private sessionCalls;
+    constructor(options?: VoiceClientOptions);
+    /**
+     * Initiate an AI-powered outbound phone call.
+     *
+     * Pricing: $0.54 per call. Returns immediately once the call is queued —
+     * poll getStatus() for transcript and recording.
+     *
+     * @example
+     *   const r = await client.call({
+     *     to: '+14155552671',
+     *     task: 'Confirm the user wants to reschedule to Tuesday 2pm.',
+     *     voice: 'maya',
+     *     max_duration: 3,
+     *   });
+     */
+    call(options: CallOptions): Promise<CallInitiatedResponse>;
+    /**
+     * Poll the status of an in-progress or completed call. Free — no payment.
+     *
+     * Returns Bland.ai's full call record: status, transcript, recording URL, etc.
+     * Most fields populate only once the call ends.
+     */
+    getStatus(callId: string): Promise<CallStatusResponse>;
+    private requestWithPayment;
+    private handlePaymentAndRetry;
+    private fetchWithTimeout;
+    getWalletAddress(): string;
+    getSpending(): Spending;
+}
+
 /**
  * BlockRun Search Client - Standalone Grok Live Search via x402 micropayments.
  *
@@ -2130,4 +2338,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 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, type SymbolListResponse, type Tool, type ToolCall, type ToolChoice, USDC_BASE, USDC_BASE_CONTRACT, USDC_SOLANA, type VideoClientOptions, type VideoClip, type VideoGenerateOptions, type VideoModel, type VideoResponse, 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, 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, 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 };