@blockrun/llm 2.1.1 → 2.3.0

package/README.md

@@ -381,8 +381,48 @@ console.log(result.data[0].duration_seconds); // 8
 const r2 = await client.generate('the subject turns and smiles', {
   imageUrl: 'https://example.com/portrait.jpg',
 });
+
+// Token360 / Seedance options (silently ignored by xAI Grok video)
+const r3 = await client.generate('aerial drone shot over a snowy mountain', {
+  model: 'bytedance/seedance-2.0-fast',
+  aspectRatio: '21:9',
+  resolution: '1080p',
+  generateAudio: true,    // omit to use the model's default
+  seed: 42,
+  watermark: false,
+  returnLastFrame: true,  // useful for clip chaining
+});
+```
+
+### Voice Calls
+
+`VoiceClient` wraps `POST /v1/voice/call` (paid, $0.54/call) and
+`GET /v1/voice/call/{callId}` (free polling) — AI-powered outbound phone
+calls powered by Bland.ai. The agent dials the recipient and runs a real-time
+conversation based on your `task` instructions. US + Canada destinations.
+
+```ts
+import { VoiceClient } from '@blockrun/llm';
+
+const client = new VoiceClient();
+
+// Initiate (paid $0.54)
+const result = await client.call({
+  to: '+14155552671',
+  task: 'You are a friendly assistant calling to confirm a 3pm dentist appointment.',
+  voice: 'maya',     // 'nat' | 'josh' | 'maya' | 'june' | 'paige' | 'derek' | 'florian'
+  max_duration: 5,   // minutes (1–30)
+});
+console.log(result.call_id);
+
+// Poll for transcript + recording (free)
+const status = await client.getStatus(result.call_id);
+console.log(status.status, status.recording_url);
 ```
 
+Bring your own caller-ID: pass `from: '+14155552671'` (must be a BlockRun
+phone number you own; buy via `/v1/phone/numbers/buy`).
+
 ### Standalone Search
 
 `SearchClient` wraps `POST /v1/search` — standalone Grok Live Search.

package/dist/index.cjs

@@ -49,6 +49,7 @@ __export(index_exports, {
   USDC_BASE_CONTRACT: () => USDC_BASE_CONTRACT,
   USDC_SOLANA: () => USDC_SOLANA,
   VideoClient: () => VideoClient,
+  VoiceClient: () => VoiceClient,
   WALLET_DIR_PATH: () => WALLET_DIR_PATH,
   WALLET_FILE_PATH: () => WALLET_FILE_PATH,
   XClient: () => XClient,
@@ -2412,6 +2413,12 @@ var VideoClient = class {
     };
     if (options?.imageUrl) body.image_url = options.imageUrl;
     if (options?.durationSeconds !== void 0) body.duration_seconds = options.durationSeconds;
+    if (options?.aspectRatio) body.aspect_ratio = options.aspectRatio;
+    if (options?.resolution) body.resolution = options.resolution;
+    if (options?.generateAudio !== void 0) body.generate_audio = options.generateAudio;
+    if (options?.seed !== void 0) body.seed = options.seed;
+    if (options?.watermark !== void 0) body.watermark = options.watermark;
+    if (options?.returnLastFrame) body.return_last_frame = true;
     const budgetMs = options?.budgetMs ?? DEFAULT_GENERATE_BUDGET_MS;
     return this.submitAndPoll(body, budgetMs);
   }
@@ -2557,15 +2564,19 @@ var VideoClient = class {
   }
 };
 
-// src/search.ts
+// src/voice.ts
 var import_accounts6 = require("viem/accounts");
 var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT5 = 6e4;
-var SearchClient = class {
+var CALL_PRICE_USD = 0.54;
+var VALID_MODELS = /* @__PURE__ */ new Set(["base", "enhanced", "turbo"]);
+var VoiceClient = class {
   account;
   privateKey;
   apiUrl;
   timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
   constructor(options = {}) {
     const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
     const privateKey = options.privateKey || envKey;
@@ -2582,6 +2593,203 @@ var SearchClient = class {
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT5;
   }
+  /**
+   * 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,
+   *   });
+   */
+  async call(options) {
+    if (!options.to || !options.to.trim()) {
+      throw new Error("'to' phone number is required (E.164 format)");
+    }
+    const task = options.task?.trim() ?? "";
+    if (task.length < 10) {
+      throw new Error("'task' must be at least 10 characters");
+    }
+    if (task.length > 4e3) {
+      throw new Error("'task' must be at most 4000 characters");
+    }
+    const maxDuration = options.max_duration ?? 5;
+    if (maxDuration < 1 || maxDuration > 30) {
+      throw new Error("max_duration must be between 1 and 30 minutes");
+    }
+    if (options.model && !VALID_MODELS.has(options.model)) {
+      throw new Error("model must be 'base' | 'enhanced' | 'turbo'");
+    }
+    if (options.interruption_threshold !== void 0 && (options.interruption_threshold < 50 || options.interruption_threshold > 500)) {
+      throw new Error("interruption_threshold must be between 50 and 500");
+    }
+    const body = {
+      to: options.to.trim(),
+      task,
+      max_duration: maxDuration,
+      language: options.language ?? "en-US"
+    };
+    if (options.from) body.from = options.from.trim();
+    if (options.voice) body.voice = options.voice;
+    if (options.first_sentence) body.first_sentence = options.first_sentence.trim();
+    if (options.wait_for_greeting !== void 0) body.wait_for_greeting = options.wait_for_greeting;
+    if (options.interruption_threshold !== void 0) body.interruption_threshold = options.interruption_threshold;
+    if (options.model) body.model = options.model;
+    return this.requestWithPayment("/v1/voice/call", body);
+  }
+  /**
+   * 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.
+   */
+  async getStatus(callId) {
+    if (!callId || !callId.trim()) {
+      throw new Error("callId is required");
+    }
+    const url = `${this.apiUrl}/v1/voice/call/${encodeURIComponent(callId.trim())}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: { Accept: "application/json" }
+    });
+    if (response.status === 404) {
+      throw new APIError(`Call not found: ${callId}`, 404, { call_id: callId });
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async requestWithPayment(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetry(url, body, response);
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async handlePaymentAndRetry(url, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402 || respBody.accepts) {
+          paymentHeader = btoa(JSON.stringify(respBody));
+        }
+      } catch {
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || `${this.apiUrl}/v1/voice/call`,
+        resourceDescription: details.resource?.description || "BlockRun Voice Call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (!retryResponse.ok) {
+      let errorBody;
+      try {
+        errorBody = await retryResponse.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error after payment: ${retryResponse.status}`, retryResponse.status, sanitizeErrorResponse(errorBody));
+    }
+    const data = await retryResponse.json();
+    this.sessionCalls++;
+    this.sessionTotalUsd += CALL_PRICE_USD;
+    const txHash = retryResponse.headers.get("x-payment-receipt") || retryResponse.headers.get("X-Payment-Receipt");
+    if (txHash) data.txHash = txHash;
+    return data;
+  }
+  async fetchWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+
+// src/search.ts
+var import_accounts7 = require("viem/accounts");
+var DEFAULT_API_URL6 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT6 = 6e4;
+var SearchClient = class {
+  account;
+  privateKey;
+  apiUrl;
+  timeout;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set BLOCKRUN_WALLET_KEY environment variable."
+      );
+    }
+    validatePrivateKey(privateKey);
+    this.privateKey = privateKey;
+    this.account = (0, import_accounts7.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL6;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT6;
+  }
   async search(query, options) {
     if (!query || query.length > 1e3) {
       throw new Error("query must be 1-1000 characters");
@@ -2694,9 +2902,9 @@ var SearchClient = class {
 };
 
 // src/x-client.ts
-var import_accounts7 = require("viem/accounts");
-var DEFAULT_API_URL6 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT6 = 6e4;
+var import_accounts8 = require("viem/accounts");
+var DEFAULT_API_URL7 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT7 = 6e4;
 var XClient = class _XClient {
   account;
   privateKey;
@@ -2719,11 +2927,11 @@ var XClient = class _XClient {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = (0, import_accounts7.privateKeyToAccount)(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL6;
+    this.account = (0, import_accounts8.privateKeyToAccount)(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT6;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
   }
   // ───────── User endpoints ─────────
   userLookup(usernames) {
@@ -2901,9 +3109,9 @@ var XClient = class _XClient {
 };
 
 // src/price.ts
-var import_accounts8 = require("viem/accounts");
-var DEFAULT_API_URL7 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT7 = 3e4;
+var import_accounts9 = require("viem/accounts");
+var DEFAULT_API_URL8 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT8 = 3e4;
 var PriceClient = class {
   account = null;
   privateKey = null;
@@ -2921,12 +3129,12 @@ var PriceClient = class {
     if (privateKey) {
       validatePrivateKey(privateKey);
       this.privateKey = privateKey;
-      this.account = (0, import_accounts8.privateKeyToAccount)(privateKey);
+      this.account = (0, import_accounts9.privateKeyToAccount)(privateKey);
     }
-    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
+    const apiUrl = options.apiUrl || DEFAULT_API_URL8;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
   }
   async price(category, symbol, options) {
     if (!symbol) throw new Error("symbol is required");
@@ -3105,7 +3313,7 @@ function buildUrl(base, query) {
 }
 
 // src/wallet.ts
-var import_accounts9 = require("viem/accounts");
+var import_accounts10 = require("viem/accounts");
 var fs2 = __toESM(require("fs"), 1);
 var path2 = __toESM(require("path"), 1);
 var os2 = __toESM(require("os"), 1);
@@ -3114,8 +3322,8 @@ var BASE_CHAIN_ID2 = "8453";
 var WALLET_DIR = path2.join(os2.homedir(), ".blockrun");
 var WALLET_FILE = path2.join(WALLET_DIR, ".session");
 function createWallet() {
-  const privateKey = (0, import_accounts9.generatePrivateKey)();
-  const account = (0, import_accounts9.privateKeyToAccount)(privateKey);
+  const privateKey = (0, import_accounts10.generatePrivateKey)();
+  const account = (0, import_accounts10.privateKeyToAccount)(privateKey);
   return {
     address: account.address,
     privateKey
@@ -3171,12 +3379,12 @@ function loadWallet() {
 function getOrCreateWallet() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    const account = (0, import_accounts9.privateKeyToAccount)(envKey);
+    const account = (0, import_accounts10.privateKeyToAccount)(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = (0, import_accounts9.privateKeyToAccount)(fileKey);
+    const account = (0, import_accounts10.privateKeyToAccount)(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -3186,11 +3394,11 @@ function getOrCreateWallet() {
 function getWalletAddress() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    return (0, import_accounts9.privateKeyToAccount)(envKey).address;
+    return (0, import_accounts10.privateKeyToAccount)(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return (0, import_accounts9.privateKeyToAccount)(fileKey).address;
+    return (0, import_accounts10.privateKeyToAccount)(fileKey).address;
   }
   return null;
 }
@@ -3370,7 +3578,7 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT8 = 6e4;
+var DEFAULT_TIMEOUT9 = 6e4;
 var SDK_VERSION2 = "0.3.0";
 var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
 var SolanaLLMClient = class {
@@ -3395,7 +3603,7 @@ var SolanaLLMClient = class {
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
-    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT9;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -4302,7 +4510,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-var import_accounts10 = require("viem/accounts");
+var import_accounts11 = require("viem/accounts");
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -4315,7 +4523,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = (0, import_accounts10.privateKeyToAccount)(this._privateKey);
+    this._account = (0, import_accounts11.privateKeyToAccount)(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -4430,6 +4638,7 @@ var AnthropicClient = class {
   USDC_BASE_CONTRACT,
   USDC_SOLANA,
   VideoClient,
+  VoiceClient,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
   XClient,

package/dist/index.d.cts

@@ -383,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;
@@ -428,6 +496,24 @@ interface VideoGenerateOptions {
     imageUrl?: string;
     /** Duration to bill for (defaults to model's default duration) */
     durationSeconds?: number;
+    /** Output aspect ratio. Token360 / Seedance only — silently ignored by xAI Grok. */
+    aspectRatio?: "adaptive" | "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
+    /** 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.
+     */
+    generateAudio?: boolean;
+    /** Reproducibility seed when supported by the model. */
+    seed?: number;
+    /** Embed the upstream watermark on the output. Defaults to false at the gateway. */
+    watermark?: boolean;
+    /** Return the last frame as an image alongside the clip — useful for chaining. */
+    returnLastFrame?: boolean;
 }
 interface SearchOptions {
     /** Source types to search (e.g. ["web", "x", "news"]) */
@@ -1416,6 +1502,83 @@ declare class VideoClient {
     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.
  *
@@ -2193,4 +2356,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, VideoClient, 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

@@ -383,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;
@@ -428,6 +496,24 @@ interface VideoGenerateOptions {
     imageUrl?: string;
     /** Duration to bill for (defaults to model's default duration) */
     durationSeconds?: number;
+    /** Output aspect ratio. Token360 / Seedance only — silently ignored by xAI Grok. */
+    aspectRatio?: "adaptive" | "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
+    /** 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.
+     */
+    generateAudio?: boolean;
+    /** Reproducibility seed when supported by the model. */
+    seed?: number;
+    /** Embed the upstream watermark on the output. Defaults to false at the gateway. */
+    watermark?: boolean;
+    /** Return the last frame as an image alongside the clip — useful for chaining. */
+    returnLastFrame?: boolean;
 }
 interface SearchOptions {
     /** Source types to search (e.g. ["web", "x", "news"]) */
@@ -1416,6 +1502,83 @@ declare class VideoClient {
     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.
  *
@@ -2193,4 +2356,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, VideoClient, 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.js

@@ -2316,6 +2316,12 @@ var VideoClient = class {
     };
     if (options?.imageUrl) body.image_url = options.imageUrl;
     if (options?.durationSeconds !== void 0) body.duration_seconds = options.durationSeconds;
+    if (options?.aspectRatio) body.aspect_ratio = options.aspectRatio;
+    if (options?.resolution) body.resolution = options.resolution;
+    if (options?.generateAudio !== void 0) body.generate_audio = options.generateAudio;
+    if (options?.seed !== void 0) body.seed = options.seed;
+    if (options?.watermark !== void 0) body.watermark = options.watermark;
+    if (options?.returnLastFrame) body.return_last_frame = true;
     const budgetMs = options?.budgetMs ?? DEFAULT_GENERATE_BUDGET_MS;
     return this.submitAndPoll(body, budgetMs);
   }
@@ -2461,15 +2467,19 @@ var VideoClient = class {
   }
 };
 
-// src/search.ts
+// src/voice.ts
 import { privateKeyToAccount as privateKeyToAccount5 } from "viem/accounts";
 var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT5 = 6e4;
-var SearchClient = class {
+var CALL_PRICE_USD = 0.54;
+var VALID_MODELS = /* @__PURE__ */ new Set(["base", "enhanced", "turbo"]);
+var VoiceClient = class {
   account;
   privateKey;
   apiUrl;
   timeout;
+  sessionTotalUsd = 0;
+  sessionCalls = 0;
   constructor(options = {}) {
     const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
     const privateKey = options.privateKey || envKey;
@@ -2486,6 +2496,203 @@ var SearchClient = class {
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT5;
   }
+  /**
+   * 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,
+   *   });
+   */
+  async call(options) {
+    if (!options.to || !options.to.trim()) {
+      throw new Error("'to' phone number is required (E.164 format)");
+    }
+    const task = options.task?.trim() ?? "";
+    if (task.length < 10) {
+      throw new Error("'task' must be at least 10 characters");
+    }
+    if (task.length > 4e3) {
+      throw new Error("'task' must be at most 4000 characters");
+    }
+    const maxDuration = options.max_duration ?? 5;
+    if (maxDuration < 1 || maxDuration > 30) {
+      throw new Error("max_duration must be between 1 and 30 minutes");
+    }
+    if (options.model && !VALID_MODELS.has(options.model)) {
+      throw new Error("model must be 'base' | 'enhanced' | 'turbo'");
+    }
+    if (options.interruption_threshold !== void 0 && (options.interruption_threshold < 50 || options.interruption_threshold > 500)) {
+      throw new Error("interruption_threshold must be between 50 and 500");
+    }
+    const body = {
+      to: options.to.trim(),
+      task,
+      max_duration: maxDuration,
+      language: options.language ?? "en-US"
+    };
+    if (options.from) body.from = options.from.trim();
+    if (options.voice) body.voice = options.voice;
+    if (options.first_sentence) body.first_sentence = options.first_sentence.trim();
+    if (options.wait_for_greeting !== void 0) body.wait_for_greeting = options.wait_for_greeting;
+    if (options.interruption_threshold !== void 0) body.interruption_threshold = options.interruption_threshold;
+    if (options.model) body.model = options.model;
+    return this.requestWithPayment("/v1/voice/call", body);
+  }
+  /**
+   * 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.
+   */
+  async getStatus(callId) {
+    if (!callId || !callId.trim()) {
+      throw new Error("callId is required");
+    }
+    const url = `${this.apiUrl}/v1/voice/call/${encodeURIComponent(callId.trim())}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: { Accept: "application/json" }
+    });
+    if (response.status === 404) {
+      throw new APIError(`Call not found: ${callId}`, 404, { call_id: callId });
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async requestWithPayment(endpoint, body) {
+    const url = `${this.apiUrl}${endpoint}`;
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetry(url, body, response);
+    }
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error: ${response.status}`, response.status, sanitizeErrorResponse(errorBody));
+    }
+    return response.json();
+  }
+  async handlePaymentAndRetry(url, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.x402 || respBody.accepts) {
+          paymentHeader = btoa(JSON.stringify(respBody));
+        }
+      } catch {
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || `${this.apiUrl}/v1/voice/call`,
+        resourceDescription: details.resource?.description || "BlockRun Voice Call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your wallet balance.");
+    }
+    if (!retryResponse.ok) {
+      let errorBody;
+      try {
+        errorBody = await retryResponse.json();
+      } catch {
+        errorBody = { error: "Request failed" };
+      }
+      throw new APIError(`API error after payment: ${retryResponse.status}`, retryResponse.status, sanitizeErrorResponse(errorBody));
+    }
+    const data = await retryResponse.json();
+    this.sessionCalls++;
+    this.sessionTotalUsd += CALL_PRICE_USD;
+    const txHash = retryResponse.headers.get("x-payment-receipt") || retryResponse.headers.get("X-Payment-Receipt");
+    if (txHash) data.txHash = txHash;
+    return data;
+  }
+  async fetchWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  getWalletAddress() {
+    return this.account.address;
+  }
+  getSpending() {
+    return { totalUsd: this.sessionTotalUsd, calls: this.sessionCalls };
+  }
+};
+
+// src/search.ts
+import { privateKeyToAccount as privateKeyToAccount6 } from "viem/accounts";
+var DEFAULT_API_URL6 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT6 = 6e4;
+var SearchClient = class {
+  account;
+  privateKey;
+  apiUrl;
+  timeout;
+  constructor(options = {}) {
+    const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
+    const privateKey = options.privateKey || envKey;
+    if (!privateKey) {
+      throw new Error(
+        "Private key required. Pass privateKey in options or set BLOCKRUN_WALLET_KEY environment variable."
+      );
+    }
+    validatePrivateKey(privateKey);
+    this.privateKey = privateKey;
+    this.account = privateKeyToAccount6(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL6;
+    validateApiUrl(apiUrl);
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.timeout = options.timeout || DEFAULT_TIMEOUT6;
+  }
   async search(query, options) {
     if (!query || query.length > 1e3) {
       throw new Error("query must be 1-1000 characters");
@@ -2598,9 +2805,9 @@ var SearchClient = class {
 };
 
 // src/x-client.ts
-import { privateKeyToAccount as privateKeyToAccount6 } from "viem/accounts";
-var DEFAULT_API_URL6 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT6 = 6e4;
+import { privateKeyToAccount as privateKeyToAccount7 } from "viem/accounts";
+var DEFAULT_API_URL7 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT7 = 6e4;
 var XClient = class _XClient {
   account;
   privateKey;
@@ -2623,11 +2830,11 @@ var XClient = class _XClient {
     }
     validatePrivateKey(privateKey);
     this.privateKey = privateKey;
-    this.account = privateKeyToAccount6(privateKey);
-    const apiUrl = options.apiUrl || DEFAULT_API_URL6;
+    this.account = privateKeyToAccount7(privateKey);
+    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT6;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
   }
   // ───────── User endpoints ─────────
   userLookup(usernames) {
@@ -2805,9 +3012,9 @@ var XClient = class _XClient {
 };
 
 // src/price.ts
-import { privateKeyToAccount as privateKeyToAccount7 } from "viem/accounts";
-var DEFAULT_API_URL7 = "https://blockrun.ai/api";
-var DEFAULT_TIMEOUT7 = 3e4;
+import { privateKeyToAccount as privateKeyToAccount8 } from "viem/accounts";
+var DEFAULT_API_URL8 = "https://blockrun.ai/api";
+var DEFAULT_TIMEOUT8 = 3e4;
 var PriceClient = class {
   account = null;
   privateKey = null;
@@ -2825,12 +3032,12 @@ var PriceClient = class {
     if (privateKey) {
       validatePrivateKey(privateKey);
       this.privateKey = privateKey;
-      this.account = privateKeyToAccount7(privateKey);
+      this.account = privateKeyToAccount8(privateKey);
     }
-    const apiUrl = options.apiUrl || DEFAULT_API_URL7;
+    const apiUrl = options.apiUrl || DEFAULT_API_URL8;
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
-    this.timeout = options.timeout || DEFAULT_TIMEOUT7;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
   }
   async price(category, symbol, options) {
     if (!symbol) throw new Error("symbol is required");
@@ -3009,7 +3216,7 @@ function buildUrl(base, query) {
 }
 
 // src/wallet.ts
-import { privateKeyToAccount as privateKeyToAccount8, generatePrivateKey } from "viem/accounts";
+import { privateKeyToAccount as privateKeyToAccount9, generatePrivateKey } from "viem/accounts";
 import * as fs2 from "fs";
 import * as path2 from "path";
 import * as os2 from "os";
@@ -3019,7 +3226,7 @@ var WALLET_DIR = path2.join(os2.homedir(), ".blockrun");
 var WALLET_FILE = path2.join(WALLET_DIR, ".session");
 function createWallet() {
   const privateKey = generatePrivateKey();
-  const account = privateKeyToAccount8(privateKey);
+  const account = privateKeyToAccount9(privateKey);
   return {
     address: account.address,
     privateKey
@@ -3075,12 +3282,12 @@ function loadWallet() {
 function getOrCreateWallet() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    const account = privateKeyToAccount8(envKey);
+    const account = privateKeyToAccount9(envKey);
     return { address: account.address, privateKey: envKey, isNew: false };
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    const account = privateKeyToAccount8(fileKey);
+    const account = privateKeyToAccount9(fileKey);
     return { address: account.address, privateKey: fileKey, isNew: false };
   }
   const { address, privateKey } = createWallet();
@@ -3090,11 +3297,11 @@ function getOrCreateWallet() {
 function getWalletAddress() {
   const envKey = typeof process !== "undefined" && process.env ? process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY : void 0;
   if (envKey) {
-    return privateKeyToAccount8(envKey).address;
+    return privateKeyToAccount9(envKey).address;
   }
   const fileKey = loadWallet();
   if (fileKey) {
-    return privateKeyToAccount8(fileKey).address;
+    return privateKeyToAccount9(fileKey).address;
   }
   return null;
 }
@@ -3274,7 +3481,7 @@ async function getOrCreateSolanaWallet() {
 // src/solana-client.ts
 var SOLANA_API_URL = "https://sol.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS2 = 1024;
-var DEFAULT_TIMEOUT8 = 6e4;
+var DEFAULT_TIMEOUT9 = 6e4;
 var SDK_VERSION2 = "0.3.0";
 var USER_AGENT2 = `blockrun-ts/${SDK_VERSION2}`;
 var SolanaLLMClient = class {
@@ -3299,7 +3506,7 @@ var SolanaLLMClient = class {
     validateApiUrl(apiUrl);
     this.apiUrl = apiUrl.replace(/\/$/, "");
     this.rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
-    this.timeout = options.timeout || DEFAULT_TIMEOUT8;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT9;
   }
   /** Get Solana wallet address (public key in base58). */
   async getWalletAddress() {
@@ -4206,7 +4413,7 @@ var OpenAI = class {
 };
 
 // src/anthropic-compat.ts
-import { privateKeyToAccount as privateKeyToAccount9 } from "viem/accounts";
+import { privateKeyToAccount as privateKeyToAccount10 } from "viem/accounts";
 var AnthropicClient = class {
   _client = null;
   _clientPromise = null;
@@ -4219,7 +4426,7 @@ var AnthropicClient = class {
     const key = options.privateKey ?? wallet.privateKey;
     validatePrivateKey(key);
     this._privateKey = key;
-    this._account = privateKeyToAccount9(this._privateKey);
+    this._account = privateKeyToAccount10(this._privateKey);
     const apiUrl = options.apiUrl ?? "https://blockrun.ai/api";
     validateApiUrl(apiUrl);
     this._apiUrl = apiUrl.replace(/\/$/, "");
@@ -4333,6 +4540,7 @@ export {
   USDC_BASE_CONTRACT,
   USDC_SOLANA,
   VideoClient,
+  VoiceClient,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
   XClient,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@blockrun/llm",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "type": "module",
-  "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music) via x402 on Base and Solana",
+  "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",