@blockrun/llm 1.13.0 → 2.0.0

package/dist/index.js

@@ -26,7 +26,7 @@ var APIError = class extends BlockrunError {
 };
 
 // src/client.ts
-import { route, DEFAULT_ROUTING_CONFIG } from "@blockrun/clawrouter";
+import { route, DEFAULT_ROUTING_CONFIG, getFallbackChain } from "@blockrun/clawrouter";
 
 // src/x402.ts
 import { signTypedData } from "viem/accounts";
@@ -341,16 +341,107 @@ function validateResourceUrl(url, baseUrl) {
   }
 }
 
+// src/cost-log.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+var BLOCKRUN_DIR = path.join(os.homedir(), ".blockrun");
+var COST_LOG_FILE = path.join(BLOCKRUN_DIR, "cost_log.jsonl");
+function logCost(entry) {
+  try {
+    fs.mkdirSync(BLOCKRUN_DIR, { recursive: true });
+  } catch {
+  }
+  try {
+    fs.appendFileSync(COST_LOG_FILE, JSON.stringify(entry) + "\n");
+  } catch {
+  }
+}
+function getCostSummary() {
+  if (!fs.existsSync(COST_LOG_FILE)) {
+    return { totalUsd: 0, calls: 0, byModel: {}, byEndpoint: {} };
+  }
+  let totalUsd = 0;
+  let calls = 0;
+  const byModel = {};
+  const byEndpoint = {};
+  try {
+    const content = fs.readFileSync(COST_LOG_FILE, "utf-8").trim();
+    if (!content) return { totalUsd: 0, calls: 0, byModel: {}, byEndpoint: {} };
+    for (const line of content.split("\n")) {
+      if (!line) continue;
+      try {
+        const raw = JSON.parse(line);
+        const cost = typeof raw.cost_usd === "number" ? raw.cost_usd : raw.costUsd ?? 0;
+        if (!cost) continue;
+        totalUsd += cost;
+        calls += 1;
+        if (raw.model) byModel[raw.model] = (byModel[raw.model] || 0) + cost;
+        if (raw.endpoint) byEndpoint[raw.endpoint] = (byEndpoint[raw.endpoint] || 0) + cost;
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return { totalUsd, calls, byModel, byEndpoint };
+}
+
 // src/client.ts
+function isTransientError(err) {
+  if (err instanceof PaymentError) return false;
+  if (err instanceof APIError) {
+    return [502, 503, 504, 522, 524].includes(err.statusCode);
+  }
+  if (err instanceof Error) {
+    if (err.name === "AbortError") return true;
+    if (err.name === "TypeError" && /fetch|network/i.test(err.message)) return true;
+  }
+  return false;
+}
+function errSummary(err) {
+  if (err instanceof APIError) return `APIError ${err.statusCode}`;
+  if (err instanceof Error) {
+    const msg = err.message.length > 80 ? err.message.slice(0, 80) : err.message;
+    return `${err.name}: ${msg}`;
+  }
+  return String(err).slice(0, 100);
+}
+function mapRawToModel(m) {
+  return {
+    id: m.id,
+    name: m.name || m.id,
+    provider: m.provider || m.owned_by || "",
+    description: m.description || "",
+    inputPrice: m.inputPrice ?? m.input_price ?? m.pricing?.input ?? 0,
+    outputPrice: m.outputPrice ?? m.output_price ?? m.pricing?.output ?? 0,
+    contextWindow: m.contextWindow ?? m.context_window ?? 0,
+    maxOutput: m.maxOutput ?? m.max_output ?? 0,
+    categories: m.categories || [],
+    available: true,
+    billingMode: m.billingMode ?? m.billing_mode,
+    flatPrice: m.flatPrice ?? m.flat_price ?? m.pricing?.flat,
+    hidden: m.hidden
+  };
+}
+function mapRawToImageModel(m) {
+  return {
+    id: m.id,
+    name: m.name || m.id,
+    provider: m.provider || m.owned_by || "",
+    description: m.description || "",
+    pricePerImage: m.pricePerImage ?? m.price_per_image ?? m.pricing?.flat ?? m.flatPrice ?? m.flat_price ?? 0,
+    supportedSizes: m.supportedSizes ?? m.supported_sizes,
+    maxPromptLength: m.maxPromptLength ?? m.max_prompt_length,
+    available: true
+  };
+}
 var DEFAULT_API_URL = "https://blockrun.ai/api";
-var TESTNET_API_URL = "https://testnet.blockrun.ai/api";
 var DEFAULT_MAX_TOKENS = 1024;
 var DEFAULT_TIMEOUT = 6e4;
 var SDK_VERSION = "1.5.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 var LLMClient = class _LLMClient {
   static DEFAULT_API_URL = DEFAULT_API_URL;
-  static TESTNET_API_URL = TESTNET_API_URL;
   account;
   privateKey;
   apiUrl;
@@ -408,7 +499,8 @@ var LLMClient = class _LLMClient {
       temperature: options?.temperature,
       topP: options?.topP,
       search: options?.search,
-      searchParameters: options?.searchParameters
+      searchParameters: options?.searchParameters,
+      fallbackModels: options?.fallbackModels
     });
     return result.choices[0].message.content || "";
   }
@@ -450,18 +542,24 @@ var LLMClient = class _LLMClient {
       modelPricing,
       routingProfile: options?.routingProfile
     });
+    const tierConfigs = decision.tierConfigs ?? DEFAULT_ROUTING_CONFIG.tiers;
+    const fullChain = getFallbackChain(decision.tier, tierConfigs);
+    const fallbacks = fullChain.filter(
+      (id) => id !== decision.model && modelPricing.has(id)
+    );
     const response = await this.chat(decision.model, prompt, {
       system: options?.system,
       maxTokens: options?.maxTokens,
       temperature: options?.temperature,
       topP: options?.topP,
       search: options?.search,
-      searchParameters: options?.searchParameters
+      searchParameters: options?.searchParameters,
+      fallbackModels: fallbacks
     });
     return {
       response,
       model: decision.model,
-      routing: decision
+      routing: { ...decision, fallbacks }
     };
   }
   /**
@@ -485,50 +583,108 @@ var LLMClient = class _LLMClient {
   }
   /**
    * Fetch model pricing from API.
+   *
+   * For flat-billed models (e.g. ZAI GLM-5 family at $0.001/call) the
+   * router still expects per-token rates, so we synthesise an equivalent
+   * per-token price assuming ~1500 total tokens per call. Without this,
+   * flat models would resolve to inputPrice=outputPrice=0 and the router
+   * would treat them as free, biasing routing decisions and reporting
+   * inflated savings %.
    */
   async fetchModelPricing() {
     const models = await this.listModels();
     const pricing = /* @__PURE__ */ new Map();
     for (const model of models) {
-      pricing.set(model.id, {
-        inputPrice: model.inputPrice,
-        outputPrice: model.outputPrice
-      });
+      if (model.billingMode === "flat" && model.flatPrice && model.flatPrice > 0) {
+        const perDirection = model.flatPrice * 1e6 / 1500 / 2;
+        pricing.set(model.id, {
+          inputPrice: perDirection,
+          outputPrice: perDirection
+        });
+      } else {
+        pricing.set(model.id, {
+          inputPrice: model.inputPrice,
+          outputPrice: model.outputPrice
+        });
+      }
     }
     return pricing;
   }
   /**
    * Full chat completion interface (OpenAI-compatible).
    *
-   * @param model - Model ID
+   * When `fallbackModels` is set, transient failures (timeouts, network
+   * errors, 5xx) on the primary model trigger a retry against the next
+   * model in the list before raising. 4xx errors and PaymentError
+   * propagate immediately — those aren't "swap upstream and retry"
+   * situations. Each fallback hop logs one stderr line.
+   *
+   * @param model - Primary model ID
    * @param messages - Array of messages with role and content
    * @param options - Optional completion parameters
    * @returns ChatResponse object with choices and usage
    */
   async chatCompletion(model, messages, options) {
-    const body = {
-      model,
-      messages,
-      max_tokens: options?.maxTokens || DEFAULT_MAX_TOKENS
+    const buildBody = (m) => {
+      const body = {
+        model: m,
+        messages,
+        max_tokens: options?.maxTokens || DEFAULT_MAX_TOKENS
+      };
+      if (options?.temperature !== void 0) body.temperature = options.temperature;
+      if (options?.topP !== void 0) body.top_p = options.topP;
+      if (options?.searchParameters !== void 0) {
+        body.search_parameters = options.searchParameters;
+      } else if (options?.search === true) {
+        body.search_parameters = { mode: "on" };
+      }
+      if (options?.tools !== void 0) body.tools = options.tools;
+      if (options?.toolChoice !== void 0) body.tool_choice = options.toolChoice;
+      return body;
     };
-    if (options?.temperature !== void 0) {
-      body.temperature = options.temperature;
-    }
-    if (options?.topP !== void 0) {
-      body.top_p = options.topP;
-    }
-    if (options?.searchParameters !== void 0) {
-      body.search_parameters = options.searchParameters;
-    } else if (options?.search === true) {
-      body.search_parameters = { mode: "on" };
-    }
-    if (options?.tools !== void 0) {
-      body.tools = options.tools;
+    const chain = [model, ...options?.fallbackModels ?? []];
+    let lastErr;
+    for (let i = 0; i < chain.length; i++) {
+      const candidate = chain[i];
+      try {
+        return await this.requestWithPayment("/v1/chat/completions", buildBody(candidate));
+      } catch (err) {
+        lastErr = err;
+        const next = chain[i + 1];
+        if (!next || !isTransientError(err)) throw err;
+        console.error(
+          `[@blockrun/llm] ${candidate} -> ${next} (${errSummary(err)})`
+        );
+      }
     }
-    if (options?.toolChoice !== void 0) {
-      body.tool_choice = options.toolChoice;
+    throw lastErr;
+  }
+  /**
+   * Write a canonical cost_log entry after a settled x402 payment.
+   * Best-effort: failures here must never break a successful API call.
+   * Mirrors what Franklin's AgentClient writes via src/agent/llm.ts so
+   * cost_log.jsonl is a single source of truth regardless of caller.
+   */
+  recordCost(url, costUsd, opts) {
+    try {
+      let endpoint = "";
+      try {
+        endpoint = new URL(url).pathname;
+      } catch {
+        endpoint = "";
+      }
+      const model = opts?.body && typeof opts.body.model === "string" ? opts.body.model : void 0;
+      logCost({
+        ts: Date.now() / 1e3,
+        endpoint,
+        cost_usd: costUsd,
+        model,
+        wallet: this.account.address,
+        network: opts?.network,
+        client_kind: "LLMClient"
+      });
+    } catch {
     }
-    return this.requestWithPayment("/v1/chat/completions", body);
   }
   /**
    * Make a request with automatic x402 payment handling.
@@ -651,6 +807,7 @@ var LLMClient = class _LLMClient {
         const costUsd2 = parseFloat(details.amount) / 1e6;
         this.sessionCalls += 1;
         this.sessionTotalUsd += costUsd2;
+        this.recordCost(url, costUsd2, { body, network: details.network });
         return retryResp2.json();
       }
     }
@@ -673,6 +830,7 @@ var LLMClient = class _LLMClient {
     const costUsd = parseFloat(details.amount) / 1e6;
     this.sessionCalls += 1;
     this.sessionTotalUsd += costUsd;
+    this.recordCost(url, costUsd, { body, network: details.network });
     return retryResponse.json();
   }
   /**
@@ -922,6 +1080,7 @@ var LLMClient = class _LLMClient {
         const costUsd2 = parseFloat(details.amount) / 1e6;
         this.sessionCalls += 1;
         this.sessionTotalUsd += costUsd2;
+        this.recordCost(url, costUsd2, { body, network: details.network });
         return retryResp2.json();
       }
     }
@@ -944,6 +1103,7 @@ var LLMClient = class _LLMClient {
     const costUsd = parseFloat(details.amount) / 1e6;
     this.sessionCalls += 1;
     this.sessionTotalUsd += costUsd;
+    this.recordCost(url, costUsd, { body, network: details.network });
     return retryResponse.json();
   }
   /**
@@ -1065,6 +1225,7 @@ var LLMClient = class _LLMClient {
         const costUsd2 = parseFloat(details.amount) / 1e6;
         this.sessionCalls += 1;
         this.sessionTotalUsd += costUsd2;
+        this.recordCost(url, costUsd2, { network: details.network });
         return retryResp2.json();
       }
     }
@@ -1087,6 +1248,7 @@ var LLMClient = class _LLMClient {
     const costUsd = parseFloat(details.amount) / 1e6;
     this.sessionCalls += 1;
     this.sessionTotalUsd += costUsd;
+    this.recordCost(url, costUsd, { network: details.network });
     return retryResponse.json();
   }
   /**
@@ -1106,9 +1268,59 @@ var LLMClient = class _LLMClient {
     }
   }
   /**
-   * List available LLM models with pricing.
+   * List available models with pricing.
+   *
+   * Returns the full `/v1/models` unified catalog (chat + image + music).
+   * The shape preserves backwards compatibility — image/music rows have
+   * `inputPrice = outputPrice = 0` since those fields don't apply, and
+   * their per-call price surfaces via `flatPrice`.
    */
   async listModels() {
+    const raw = await this.fetchRawModels();
+    return raw.map((m) => mapRawToModel(m));
+  }
+  /**
+   * List available image generation models with pricing.
+   *
+   * The dedicated `/v1/images/models` endpoint was deprecated server-side;
+   * image models live in the unified `/v1/models` catalog under
+   * `categories: ["image", ...]`. This method filters that catalog so
+   * existing callers keep working.
+   */
+  async listImageModels() {
+    const raw = await this.fetchRawModels();
+    return raw.filter((m) => Array.isArray(m.categories) && m.categories.includes("image")).map((m) => mapRawToImageModel(m));
+  }
+  /**
+   * List all available models (chat, image, music, etc.) with pricing.
+   *
+   * @returns Array of all models with `type` field set from category
+   * (`llm` for chat, `image` / `music` for media). Backwards-compat:
+   * chat models always report `type: "llm"`.
+   */
+  async listAllModels() {
+    const raw = await this.fetchRawModels();
+    const out = [];
+    for (const m of raw) {
+      const cats = Array.isArray(m.categories) ? m.categories : [];
+      if (cats.includes("image")) {
+        const model = mapRawToImageModel(m);
+        model.type = "image";
+        out.push(model);
+      } else {
+        const model = mapRawToModel(m);
+        model.type = "llm";
+        out.push(model);
+      }
+    }
+    return out;
+  }
+  /**
+   * Internal: fetch the raw `/v1/models` catalog without normalising shape.
+   * Used by listImageModels / listAllModels so each can pick category-
+   * specific fields.
+   */
+  async fetchRawModels() {
     const response = await this.fetchWithTimeout(`${this.apiUrl}/v1/models`, {
       method: "GET"
     });
@@ -1126,65 +1338,8 @@ var LLMClient = class _LLMClient {
       );
     }
     const data = await response.json();
-    return (data.data || []).map((m) => ({
-      id: m.id,
-      name: m.name || m.id,
-      provider: m.provider || m.owned_by || "",
-      description: m.description || "",
-      inputPrice: m.inputPrice ?? m.input_price ?? m.pricing?.input ?? 0,
-      outputPrice: m.outputPrice ?? m.output_price ?? m.pricing?.output ?? 0,
-      contextWindow: m.contextWindow ?? m.context_window ?? 0,
-      maxOutput: m.maxOutput ?? m.max_output ?? 0,
-      categories: m.categories || [],
-      available: true,
-      billingMode: m.billingMode ?? m.billing_mode,
-      flatPrice: m.flatPrice ?? m.flat_price ?? m.pricing?.flat,
-      hidden: m.hidden
-    }));
-  }
-  /**
-   * List available image generation models with pricing.
-   */
-  async listImageModels() {
-    const response = await this.fetchWithTimeout(
-      `${this.apiUrl}/v1/images/models`,
-      { method: "GET" }
-    );
-    if (!response.ok) {
-      throw new APIError(
-        `Failed to list image models: ${response.status}`,
-        response.status
-      );
-    }
-    const data = await response.json();
     return data.data || [];
   }
-  /**
-   * List all available models (both LLM and image) with pricing.
-   *
-   * @returns Array of all models with 'type' field ('llm' or 'image')
-   *
-   * @example
-   * const models = await client.listAllModels();
-   * for (const model of models) {
-   *   if (model.type === 'llm') {
-   *     console.log(`LLM: ${model.id} - $${model.inputPrice}/M input`);
-   *   } else {
-   *     console.log(`Image: ${model.id} - $${model.pricePerImage}/image`);
-   *   }
-   * }
-   */
-  async listAllModels() {
-    const llmModels = await this.listModels();
-    for (const model of llmModels) {
-      model.type = "llm";
-    }
-    const imageModels = await this.listImageModels();
-    for (const model of imageModels) {
-      model.type = "image";
-    }
-    return [...llmModels, ...imageModels];
-  }
   /**
    * Edit an image using img2img.
    *
@@ -1225,6 +1380,19 @@ var LLMClient = class _LLMClient {
     const data = await this.requestWithPaymentRaw("/v1/search", body);
     return data;
   }
+  /**
+   * Generic Exa endpoint proxy (POST). Useful when you need an Exa API
+   * surface that the typed wrappers below don't expose.
+   *
+   * @param path - Exa endpoint segment: "search" | "find-similar" | "contents" | "answer"
+   * @param body - Request body (see Exa API docs)
+   *
+   * @example
+   * const results = await client.exa("search", { query: "latest AI research", numResults: 5 });
+   */
+  async exa(path5, body) {
+    return this.requestWithPaymentRaw(`/v1/exa/${path5}`, body);
+  }
   /**
    * Neural web search via Exa. Returns semantically relevant URLs and metadata.
    * Understands meaning, not just keywords. $0.01/call.
@@ -1278,9 +1446,7 @@ var LLMClient = class _LLMClient {
     return data.data;
   }
   /**
-   * Get USDC balance on Base network.
-   *
-   * Automatically detects mainnet vs testnet based on API URL.
+   * Get USDC balance on Base mainnet.
    *
    * @returns USDC balance as a float (6 decimal places normalized)
    *
@@ -1289,9 +1455,8 @@ var LLMClient = class _LLMClient {
    * console.log(`Balance: $${balance.toFixed(2)} USDC`);
    */
   async getBalance() {
-    const isTestnet = this.isTestnet();
-    const usdcContract = isTestnet ? "0x036CbD53842c5426634e7929541eC2318f3dCF7e" : "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
-    const rpcs = isTestnet ? ["https://sepolia.base.org", "https://base-sepolia-rpc.publicnode.com"] : ["https://base.publicnode.com", "https://mainnet.base.org", "https://base.meowrpc.com"];
+    const usdcContract = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    const rpcs = ["https://base.publicnode.com", "https://mainnet.base.org", "https://base.meowrpc.com"];
     const selector = "0x70a08231";
     const paddedAddress = this.account.address.slice(2).toLowerCase().padStart(64, "0");
     const data = selector + paddedAddress;
@@ -1537,17 +1702,70 @@ var LLMClient = class _LLMClient {
   /**
    * Structured query for Predexon prediction market data (POST endpoints).
    *
-   * For complex queries that require a JSON body. $0.005 per request.
+   * For endpoints that require a JSON body, e.g. bulk wallet identity lookup.
+   * Tier 1 = $0.001/call, Tier 2 = $0.005/call.
    *
-   * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+   * @param path - Endpoint path, e.g. "polymarket/wallet/identities"
    * @param query - JSON body for the structured query
    *
    * @example
-   * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+   * const batch = await client.pmQuery("polymarket/wallet/identities", {
+   *   addresses: ["0xabc...", "0xdef..."],
+   * });
    */
   async pmQuery(path5, query) {
     return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
   }
+  // ── PM convenience helpers (Predexon v2) ─────────────────────────────────
+  // Thin wrappers over pm() / pmQuery() for the most common v2 endpoints.
+  /** List canonical cross-venue markets (Predexon v2). Tier 1 ($0.001/call).
+   * Filter with venue, status, category, league, event_id, pagination_key. */
+  async pmMarkets(params) {
+    return this.pm("markets", params);
+  }
+  /** List venue-native executable listings flattened across canonical markets
+   * (Predexon v2). Tier 1 ($0.001/call). */
+  async pmListings(params) {
+    return this.pm("markets/listings", params);
+  }
+  /** Resolve a canonical Predexon outcome ID to its market context and venue
+   * listings. Tier 1 ($0.001/call). */
+  async pmOutcome(predexonId) {
+    return this.pm(`outcomes/${predexonId}`);
+  }
+  /** Polymarket markets with cursor-based keyset pagination (use pagination_key).
+   * Tier 1 ($0.001/call). */
+  async pmPolymarketMarketsKeyset(params) {
+    return this.pm("polymarket/markets/keyset", params);
+  }
+  /** Polymarket events with cursor-based keyset pagination (use pagination_key).
+   * Tier 1 ($0.001/call). */
+  async pmPolymarketEventsKeyset(params) {
+    return this.pm("polymarket/events/keyset", params);
+  }
+  /** List available sports categories. Tier 1 ($0.001/call). */
+  async pmSportsCategories() {
+    return this.pm("sports/categories");
+  }
+  /** List sports markets grouped by game. Filter with league, sport_type,
+   * status, venue. Tier 1 ($0.001/call). */
+  async pmSportsMarkets(params) {
+    return this.pm("sports/markets", params);
+  }
+  /** Fetch identity + profile metadata for one wallet (ENS, Twitter, portfolio,
+   * etc.). Tier 2 ($0.005/call). */
+  async pmWalletIdentity(wallet) {
+    return this.pm(`polymarket/wallet/identity/${wallet}`);
+  }
+  /** Bulk identity lookup for up to 200 wallet addresses (POST). Tier 2 ($0.005/call). */
+  async pmWalletIdentities(addresses) {
+    return this.pmQuery("polymarket/wallet/identities", { addresses });
+  }
+  /** Discover wallets connected to a seed address via on-chain transfers and
+   * identity proofs. Tier 2 ($0.005/call). */
+  async pmWalletCluster(address) {
+    return this.pm(`polymarket/wallet/${address}/cluster`);
+  }
   /**
    * Get current session spending.
    *
@@ -1569,19 +1787,7 @@ var LLMClient = class _LLMClient {
   getWalletAddress() {
     return this.account.address;
   }
-  /**
-   * Check if client is configured for testnet.
-   */
-  isTestnet() {
-    return this.apiUrl.includes("testnet.blockrun.ai");
-  }
 };
-function testnetClient(options = {}) {
-  return new LLMClient({
-    ...options,
-    apiUrl: TESTNET_API_URL
-  });
-}
 var client_default = LLMClient;
 
 // src/image.ts
@@ -1670,10 +1876,15 @@ var ImageClient = class {
   }
   /**
    * List available image generation models with pricing.
+   *
+   * The dedicated `/v1/images/models` endpoint was deprecated server-side;
+   * image models live in the unified `/v1/models` catalog under
+   * `categories: ["image", ...]`. This method filters that catalog so
+   * existing callers keep working.
    */
   async listImageModels() {
     const response = await this.fetchWithTimeout(
-      `${this.apiUrl}/v1/images/models`,
+      `${this.apiUrl}/v1/models`,
       { method: "GET" }
     );
     if (!response.ok) {
@@ -1683,7 +1894,16 @@ var ImageClient = class {
       );
     }
     const data = await response.json();
-    return data.data || [];
+    return (data.data || []).filter((m) => Array.isArray(m.categories) && m.categories.includes("image")).map((m) => ({
+      id: m.id,
+      name: m.name || m.id,
+      provider: m.provider || m.owned_by || "",
+      description: m.description || "",
+      pricePerImage: m.pricePerImage ?? m.price_per_image ?? m.pricing?.flat ?? m.flatPrice ?? m.flat_price ?? 0,
+      supportedSizes: m.supportedSizes ?? m.supported_sizes,
+      maxPromptLength: m.maxPromptLength ?? m.max_prompt_length,
+      available: true
+    }));
   }
   /**
    * Make a request with automatic x402 payment handling.
@@ -2169,12 +2389,19 @@ var SearchClient = class {
 import { privateKeyToAccount as privateKeyToAccount5 } from "viem/accounts";
 var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_TIMEOUT5 = 6e4;
-var XClient = class {
+var XClient = class _XClient {
   account;
   privateKey;
   apiUrl;
   timeout;
+  static deprecationWarned = false;
   constructor(options = {}) {
+    if (!_XClient.deprecationWarned) {
+      console.warn(
+        "[@blockrun/llm] XClient: BlockRun's /v1/x/* (AttentionVC) integration was removed 2026-04-30. All calls will return HTTP 404 until a replacement X data upstream is reintroduced."
+      );
+      _XClient.deprecationWarned = true;
+    }
     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) {
@@ -2571,13 +2798,13 @@ function buildUrl(base, query) {
 
 // src/wallet.ts
 import { privateKeyToAccount as privateKeyToAccount7, generatePrivateKey } from "viem/accounts";
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
 var USDC_BASE_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var BASE_CHAIN_ID2 = "8453";
-var WALLET_DIR = path.join(os.homedir(), ".blockrun");
-var WALLET_FILE = path.join(WALLET_DIR, ".session");
+var WALLET_DIR = path2.join(os2.homedir(), ".blockrun");
+var WALLET_FILE = path2.join(WALLET_DIR, ".session");
 function createWallet() {
   const privateKey = generatePrivateKey();
   const account = privateKeyToAccount7(privateKey);
@@ -2587,27 +2814,27 @@ function createWallet() {
   };
 }
 function saveWallet(privateKey) {
-  if (!fs.existsSync(WALLET_DIR)) {
-    fs.mkdirSync(WALLET_DIR, { recursive: true });
+  if (!fs2.existsSync(WALLET_DIR)) {
+    fs2.mkdirSync(WALLET_DIR, { recursive: true });
   }
-  fs.writeFileSync(WALLET_FILE, privateKey, { mode: 384 });
+  fs2.writeFileSync(WALLET_FILE, privateKey, { mode: 384 });
   return WALLET_FILE;
 }
 function scanWallets() {
-  const home = os.homedir();
+  const home = os2.homedir();
   const results = [];
   try {
-    const entries = fs.readdirSync(home, { withFileTypes: true });
+    const entries = fs2.readdirSync(home, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.name.startsWith(".") || !entry.isDirectory()) continue;
-      const walletFile = path.join(home, entry.name, "wallet.json");
-      if (!fs.existsSync(walletFile)) continue;
+      const walletFile = path2.join(home, entry.name, "wallet.json");
+      if (!fs2.existsSync(walletFile)) continue;
       try {
-        const data = JSON.parse(fs.readFileSync(walletFile, "utf-8"));
+        const data = JSON.parse(fs2.readFileSync(walletFile, "utf-8"));
         const pk = data.privateKey || "";
         const addr = data.address || "";
         if (pk && addr) {
-          const mtime = fs.statSync(walletFile).mtimeMs;
+          const mtime = fs2.statSync(walletFile).mtimeMs;
           results.push({ mtime, privateKey: pk, address: addr });
         }
       } catch {
@@ -2622,13 +2849,13 @@ function scanWallets() {
 function loadWallet() {
   const wallets = scanWallets();
   if (wallets.length > 0) return wallets[0].privateKey;
-  if (fs.existsSync(WALLET_FILE)) {
-    const key = fs.readFileSync(WALLET_FILE, "utf-8").trim();
+  if (fs2.existsSync(WALLET_FILE)) {
+    const key = fs2.readFileSync(WALLET_FILE, "utf-8").trim();
     if (key) return key;
   }
-  const legacyFile = path.join(WALLET_DIR, "wallet.key");
-  if (fs.existsSync(legacyFile)) {
-    const key = fs.readFileSync(legacyFile, "utf-8").trim();
+  const legacyFile = path2.join(WALLET_DIR, "wallet.key");
+  if (fs2.existsSync(legacyFile)) {
+    const key = fs2.readFileSync(legacyFile, "utf-8").trim();
     if (key) return key;
   }
   return null;
@@ -2723,11 +2950,11 @@ var WALLET_FILE_PATH = WALLET_FILE;
 var WALLET_DIR_PATH = WALLET_DIR;
 
 // src/solana-wallet.ts
-import * as fs2 from "fs";
-import * as path2 from "path";
-import * as os2 from "os";
-var WALLET_DIR2 = path2.join(os2.homedir(), ".blockrun");
-var SOLANA_WALLET_FILE = path2.join(WALLET_DIR2, ".solana-session");
+import * as fs3 from "fs";
+import * as path3 from "path";
+import * as os3 from "os";
+var WALLET_DIR2 = path3.join(os3.homedir(), ".blockrun");
+var SOLANA_WALLET_FILE = path3.join(WALLET_DIR2, ".solana-session");
 async function createSolanaWallet() {
   const { Keypair } = await import("@solana/web3.js");
   const bs58 = await import("bs58");
@@ -2756,39 +2983,39 @@ async function solanaPublicKey(privateKey) {
   return Keypair.fromSecretKey(bytes).publicKey.toBase58();
 }
 function saveSolanaWallet(privateKey) {
-  if (!fs2.existsSync(WALLET_DIR2)) fs2.mkdirSync(WALLET_DIR2, { recursive: true });
-  fs2.writeFileSync(SOLANA_WALLET_FILE, privateKey, { mode: 384 });
+  if (!fs3.existsSync(WALLET_DIR2)) fs3.mkdirSync(WALLET_DIR2, { recursive: true });
+  fs3.writeFileSync(SOLANA_WALLET_FILE, privateKey, { mode: 384 });
   return SOLANA_WALLET_FILE;
 }
 function scanSolanaWallets() {
-  const home = os2.homedir();
+  const home = os3.homedir();
   const results = [];
   try {
-    const entries = fs2.readdirSync(home, { withFileTypes: true });
+    const entries = fs3.readdirSync(home, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.name.startsWith(".") || !entry.isDirectory()) continue;
-      const solanaWalletFile = path2.join(home, entry.name, "solana-wallet.json");
-      if (fs2.existsSync(solanaWalletFile)) {
+      const solanaWalletFile = path3.join(home, entry.name, "solana-wallet.json");
+      if (fs3.existsSync(solanaWalletFile)) {
         try {
-          const data = JSON.parse(fs2.readFileSync(solanaWalletFile, "utf-8"));
+          const data = JSON.parse(fs3.readFileSync(solanaWalletFile, "utf-8"));
           const pk = data.privateKey || "";
           const addr = data.address || "";
           if (pk && addr) {
-            const mtime = fs2.statSync(solanaWalletFile).mtimeMs;
+            const mtime = fs3.statSync(solanaWalletFile).mtimeMs;
             results.push({ mtime, secretKey: pk, publicKey: addr });
           }
         } catch {
         }
       }
       if (entry.name === ".brcc") {
-        const brccWalletFile = path2.join(home, entry.name, "wallet.json");
-        if (fs2.existsSync(brccWalletFile)) {
+        const brccWalletFile = path3.join(home, entry.name, "wallet.json");
+        if (fs3.existsSync(brccWalletFile)) {
           try {
-            const data = JSON.parse(fs2.readFileSync(brccWalletFile, "utf-8"));
+            const data = JSON.parse(fs3.readFileSync(brccWalletFile, "utf-8"));
             const pk = data.privateKey || "";
             const addr = data.address || "";
             if (pk && addr) {
-              const mtime = fs2.statSync(brccWalletFile).mtimeMs;
+              const mtime = fs3.statSync(brccWalletFile).mtimeMs;
               results.push({ mtime, secretKey: pk, publicKey: addr });
             }
           } catch {
@@ -2804,8 +3031,8 @@ function scanSolanaWallets() {
 function loadSolanaWallet() {
   const wallets = scanSolanaWallets();
   if (wallets.length > 0) return wallets[0].secretKey;
-  if (fs2.existsSync(SOLANA_WALLET_FILE)) {
-    const key = fs2.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
+  if (fs3.existsSync(SOLANA_WALLET_FILE)) {
+    const key = fs3.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
     if (key) return key;
   }
   return null;
@@ -2820,8 +3047,8 @@ async function getOrCreateSolanaWallet() {
   if (wallets.length > 0) {
     return { privateKey: wallets[0].secretKey, address: wallets[0].publicKey, isNew: false };
   }
-  if (fs2.existsSync(SOLANA_WALLET_FILE)) {
-    const fileKey = fs2.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
+  if (fs3.existsSync(SOLANA_WALLET_FILE)) {
+    const fileKey = fs3.readFileSync(SOLANA_WALLET_FILE, "utf-8").trim();
     if (fileKey) {
       const address2 = await solanaPublicKey(fileKey);
       return { privateKey: fileKey, address: address2, isNew: false };
@@ -3395,13 +3622,13 @@ function solanaClient(options = {}) {
 }
 
 // src/cache.ts
-import * as fs3 from "fs";
-import * as path3 from "path";
-import * as os3 from "os";
+import * as fs4 from "fs";
+import * as path4 from "path";
+import * as os4 from "os";
 import * as crypto2 from "crypto";
-var CACHE_DIR = path3.join(os3.homedir(), ".blockrun", "cache");
-var DATA_DIR = path3.join(os3.homedir(), ".blockrun", "data");
-var COST_LOG_FILE = path3.join(os3.homedir(), ".blockrun", "cost_log.jsonl");
+var CACHE_DIR = path4.join(os4.homedir(), ".blockrun", "cache");
+var DATA_DIR = path4.join(os4.homedir(), ".blockrun", "data");
+var COST_LOG_FILE2 = path4.join(os4.homedir(), ".blockrun", "cost_log.jsonl");
 var DEFAULT_TTL = {
   "/v1/x/": 3600 * 1e3,
   "/v1/partner/": 3600 * 1e3,
@@ -3422,19 +3649,19 @@ function cacheKey(endpoint, body) {
   return crypto2.createHash("sha256").update(keyData).digest("hex").slice(0, 16);
 }
 function cachePath(key) {
-  return path3.join(CACHE_DIR, `${key}.json`);
+  return path4.join(CACHE_DIR, `${key}.json`);
 }
 function getCached(key) {
   const filePath = cachePath(key);
-  if (!fs3.existsSync(filePath)) return null;
+  if (!fs4.existsSync(filePath)) return null;
   try {
-    const raw = fs3.readFileSync(filePath, "utf-8");
+    const raw = fs4.readFileSync(filePath, "utf-8");
     const entry = JSON.parse(raw);
     const ttl = entry.ttlMs ?? getTtl(entry.endpoint ?? "");
     if (ttl <= 0) return null;
     if (Date.now() - entry.cachedAt > ttl) {
       try {
-        fs3.unlinkSync(filePath);
+        fs4.unlinkSync(filePath);
       } catch {
       }
       return null;
@@ -3453,7 +3680,7 @@ function getCachedByRequest(endpoint, body) {
 function setCache(key, data, ttlMs) {
   if (ttlMs <= 0) return;
   try {
-    fs3.mkdirSync(CACHE_DIR, { recursive: true });
+    fs4.mkdirSync(CACHE_DIR, { recursive: true });
   } catch {
   }
   const entry = {
@@ -3462,7 +3689,7 @@ function setCache(key, data, ttlMs) {
     ttlMs
   };
   try {
-    fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+    fs4.writeFileSync(cachePath(key), JSON.stringify(entry));
   } catch {
   }
 }
@@ -3485,7 +3712,7 @@ function readableFilename(endpoint, body) {
 }
 function saveReadable(endpoint, body, response, costUsd) {
   try {
-    fs3.mkdirSync(DATA_DIR, { recursive: true });
+    fs4.mkdirSync(DATA_DIR, { recursive: true });
   } catch {
   }
   const filename = readableFilename(endpoint, body);
@@ -3497,14 +3724,14 @@ function saveReadable(endpoint, body, response, costUsd) {
     response
   };
   try {
-    fs3.writeFileSync(path3.join(DATA_DIR, filename), JSON.stringify(entry, null, 2));
+    fs4.writeFileSync(path4.join(DATA_DIR, filename), JSON.stringify(entry, null, 2));
   } catch {
   }
 }
 function appendCostLog(endpoint, costUsd) {
   if (costUsd <= 0) return;
   try {
-    fs3.mkdirSync(path3.dirname(COST_LOG_FILE), { recursive: true });
+    fs4.mkdirSync(path4.dirname(COST_LOG_FILE2), { recursive: true });
   } catch {
   }
   const entry = {
@@ -3513,7 +3740,7 @@ function appendCostLog(endpoint, costUsd) {
     cost_usd: costUsd
   };
   try {
-    fs3.appendFileSync(COST_LOG_FILE, JSON.stringify(entry) + "\n");
+    fs4.appendFileSync(COST_LOG_FILE2, JSON.stringify(entry) + "\n");
   } catch {
   }
 }
@@ -3521,7 +3748,7 @@ function saveToCache(endpoint, body, response, costUsd = 0) {
   const ttl = getTtl(endpoint);
   if (ttl > 0) {
     try {
-      fs3.mkdirSync(CACHE_DIR, { recursive: true });
+      fs4.mkdirSync(CACHE_DIR, { recursive: true });
     } catch {
     }
     const key = cacheKey(endpoint, body);
@@ -3533,7 +3760,7 @@ function saveToCache(endpoint, body, response, costUsd = 0) {
       costUsd
     };
     try {
-      fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+      fs4.writeFileSync(cachePath(key), JSON.stringify(entry));
     } catch {
     }
   }
@@ -3541,14 +3768,14 @@ function saveToCache(endpoint, body, response, costUsd = 0) {
   appendCostLog(endpoint, costUsd);
 }
 function clearCache() {
-  if (!fs3.existsSync(CACHE_DIR)) return 0;
+  if (!fs4.existsSync(CACHE_DIR)) return 0;
   let count = 0;
   try {
-    const files = fs3.readdirSync(CACHE_DIR);
+    const files = fs4.readdirSync(CACHE_DIR);
     for (const file of files) {
       if (file.endsWith(".json")) {
         try {
-          fs3.unlinkSync(path3.join(CACHE_DIR, file));
+          fs4.unlinkSync(path4.join(CACHE_DIR, file));
           count++;
         } catch {
         }
@@ -3559,14 +3786,14 @@ function clearCache() {
   return count;
 }
 function getCostLogSummary() {
-  if (!fs3.existsSync(COST_LOG_FILE)) {
+  if (!fs4.existsSync(COST_LOG_FILE2)) {
     return { totalUsd: 0, calls: 0, byEndpoint: {} };
   }
   let totalUsd = 0;
   let calls = 0;
   const byEndpoint = {};
   try {
-    const content = fs3.readFileSync(COST_LOG_FILE, "utf-8").trim();
+    const content = fs4.readFileSync(COST_LOG_FILE2, "utf-8").trim();
     if (!content) return { totalUsd: 0, calls: 0, byEndpoint: {} };
     for (const line of content.split("\n")) {
       if (!line) continue;
@@ -3621,47 +3848,6 @@ async function status() {
   return { address, balance };
 }
 
-// src/cost-log.ts
-import * as fs4 from "fs";
-import * as path4 from "path";
-import * as os4 from "os";
-var DATA_DIR2 = path4.join(os4.homedir(), ".blockrun", "data");
-var COST_LOG_FILE2 = path4.join(DATA_DIR2, "costs.jsonl");
-function logCost(entry) {
-  try {
-    fs4.mkdirSync(DATA_DIR2, { recursive: true });
-  } catch {
-  }
-  try {
-    fs4.appendFileSync(COST_LOG_FILE2, JSON.stringify(entry) + "\n");
-  } catch {
-  }
-}
-function getCostSummary() {
-  if (!fs4.existsSync(COST_LOG_FILE2)) {
-    return { totalUsd: 0, calls: 0, byModel: {} };
-  }
-  let totalUsd = 0;
-  let calls = 0;
-  const byModel = {};
-  try {
-    const content = fs4.readFileSync(COST_LOG_FILE2, "utf-8").trim();
-    if (!content) return { totalUsd: 0, calls: 0, byModel: {} };
-    for (const line of content.split("\n")) {
-      if (!line) continue;
-      try {
-        const entry = JSON.parse(line);
-        totalUsd += entry.costUsd;
-        calls += 1;
-        byModel[entry.model] = (byModel[entry.model] || 0) + entry.costUsd;
-      } catch {
-      }
-    }
-  } catch {
-  }
-  return { totalUsd, calls, byModel };
-}
-
 // src/openai-compat.ts
 var StreamingResponse = class {
   reader;
@@ -3969,7 +4155,6 @@ export {
   solanaKeyToBytes,
   solanaPublicKey,
   status,
-  testnetClient,
   validateMaxTokens,
   validateModel,
   validateTemperature,