@blockrun/llm 1.4.2 → 1.5.0

package/dist/index.js

@@ -1,9 +1,9 @@
-import {
-  __require,
-  __toCommonJS,
-  index_esm_exports,
-  init_index_esm
-} from "./chunk-KRDGCX7W.js";
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/client.ts
 import { privateKeyToAccount } from "viem/accounts";
@@ -116,9 +116,9 @@ async function createPaymentPayload(privateKey, fromAddress, recipient, amount,
   return btoa(JSON.stringify(paymentData));
 }
 async function createSolanaPaymentPayload(secretKey, fromAddress, recipient, amount, feePayer, options = {}) {
-  const { Connection, PublicKey, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } = await import("./index.esm-SXKIFLA7.js");
-  const { getAssociatedTokenAddress, createTransferCheckedInstruction, getMint } = await import("./esm-PTFDM6PE.js");
-  const { Keypair } = await import("./index.esm-SXKIFLA7.js");
+  const { Connection, PublicKey, TransactionMessage, VersionedTransaction, ComputeBudgetProgram } = await import("@solana/web3.js");
+  const { getAssociatedTokenAddress, createTransferCheckedInstruction, getMint } = await import("@solana/spl-token");
+  const { Keypair } = await import("@solana/web3.js");
   const rpcUrl = options.rpcUrl || "https://api.mainnet-beta.solana.com";
   const connection = new Connection(rpcUrl);
   const keypair = Keypair.fromSecretKey(secretKey);
@@ -223,6 +223,61 @@ function extractPaymentDetails(paymentRequired, preferredNetwork) {
 
 // src/validation.ts
 var LOCALHOST_DOMAINS = ["localhost", "127.0.0.1"];
+var KNOWN_PROVIDERS = /* @__PURE__ */ new Set([
+  "openai",
+  "anthropic",
+  "google",
+  "deepseek",
+  "mistralai",
+  "meta-llama",
+  "together",
+  "xai",
+  "moonshot",
+  "nvidia",
+  "minimax",
+  "zai"
+]);
+function validateModel(model) {
+  if (!model || typeof model !== "string") {
+    throw new Error("Model must be a non-empty string");
+  }
+}
+function validateMaxTokens(maxTokens) {
+  if (maxTokens === void 0 || maxTokens === null) {
+    return;
+  }
+  if (typeof maxTokens !== "number" || !Number.isInteger(maxTokens)) {
+    throw new Error("maxTokens must be an integer");
+  }
+  if (maxTokens < 1) {
+    throw new Error("maxTokens must be positive (minimum: 1)");
+  }
+  if (maxTokens > 1e5) {
+    throw new Error("maxTokens too large (maximum: 100000)");
+  }
+}
+function validateTemperature(temperature) {
+  if (temperature === void 0 || temperature === null) {
+    return;
+  }
+  if (typeof temperature !== "number") {
+    throw new Error("temperature must be a number");
+  }
+  if (temperature < 0 || temperature > 2) {
+    throw new Error("temperature must be between 0 and 2");
+  }
+}
+function validateTopP(topP) {
+  if (topP === void 0 || topP === null) {
+    return;
+  }
+  if (typeof topP !== "number") {
+    throw new Error("topP must be a number");
+  }
+  if (topP < 0 || topP > 1) {
+    throw new Error("topP must be between 0 and 1");
+  }
+}
 function validatePrivateKey(key) {
   if (typeof key !== "string") {
     throw new Error("Private key must be a string");
@@ -298,7 +353,7 @@ 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 = "0.3.0";
+var SDK_VERSION = "1.5.0";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 var LLMClient = class {
   static DEFAULT_API_URL = DEFAULT_API_URL;
@@ -335,13 +390,13 @@ var LLMClient = class {
   /**
    * Simple 1-line chat interface.
    *
-   * @param model - Model ID (e.g., 'openai/gpt-4o', 'anthropic/claude-sonnet-4')
+   * @param model - Model ID (e.g., 'openai/gpt-5.2', 'anthropic/claude-sonnet-4.6')
    * @param prompt - User message
    * @param options - Optional chat parameters
    * @returns Assistant's response text
    *
    * @example
-   * const response = await client.chat('gpt-4o', 'What is the capital of France?');
+   * const response = await client.chat('gpt-5.2', 'What is the capital of France?');
    * console.log(response); // 'The capital of France is Paris.'
    */
   async chat(model, prompt, options) {
@@ -487,6 +542,27 @@ var LLMClient = class {
       headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
       body: JSON.stringify(body)
     });
+    if (response.status === 502 || response.status === 503) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      const retryResp = await this.fetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
+        body: JSON.stringify(body)
+      });
+      if (retryResp.status !== 502 && retryResp.status !== 503) {
+        if (retryResp.status === 402) return this.handlePaymentAndRetry(url, body, retryResp);
+        if (!retryResp.ok) {
+          let errorBody;
+          try {
+            errorBody = await retryResp.json();
+          } catch {
+            errorBody = { error: "Request failed" };
+          }
+          throw new APIError(`API error: ${retryResp.status}`, retryResp.status, sanitizeErrorResponse(errorBody));
+        }
+        return retryResp.json();
+      }
+    }
     if (response.status === 402) {
       return this.handlePaymentAndRetry(url, body, response);
     }
@@ -552,6 +628,34 @@ var LLMClient = class {
       },
       body: JSON.stringify(body)
     });
+    if (retryResponse.status === 502 || retryResponse.status === 503) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      const retryResp2 = await this.fetchWithTimeout(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "User-Agent": USER_AGENT,
+          "PAYMENT-SIGNATURE": paymentPayload
+        },
+        body: JSON.stringify(body)
+      });
+      if (retryResp2.status !== 502 && retryResp2.status !== 503) {
+        if (retryResp2.status === 402) throw new PaymentError("Payment was rejected. Check your wallet balance.");
+        if (!retryResp2.ok) {
+          let errorBody;
+          try {
+            errorBody = await retryResp2.json();
+          } catch {
+            errorBody = { error: "Request failed" };
+          }
+          throw new APIError(`API error after payment: ${retryResp2.status}`, retryResp2.status, sanitizeErrorResponse(errorBody));
+        }
+        const costUsd2 = parseFloat(details.amount) / 1e6;
+        this.sessionCalls += 1;
+        this.sessionTotalUsd += costUsd2;
+        return retryResp2.json();
+      }
+    }
     if (retryResponse.status === 402) {
       throw new PaymentError("Payment was rejected. Check your wallet balance.");
     }
@@ -584,6 +688,27 @@ var LLMClient = class {
       headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
       body: JSON.stringify(body)
     });
+    if (response.status === 502 || response.status === 503) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      const retryResp = await this.fetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
+        body: JSON.stringify(body)
+      });
+      if (retryResp.status !== 502 && retryResp.status !== 503) {
+        if (retryResp.status === 402) return this.handlePaymentAndRetryRaw(url, body, retryResp);
+        if (!retryResp.ok) {
+          let errorBody;
+          try {
+            errorBody = await retryResp.json();
+          } catch {
+            errorBody = { error: "Request failed" };
+          }
+          throw new APIError(`API error: ${retryResp.status}`, retryResp.status, sanitizeErrorResponse(errorBody));
+        }
+        return retryResp.json();
+      }
+    }
     if (response.status === 402) {
       return this.handlePaymentAndRetryRaw(url, body, response);
     }
@@ -649,6 +774,34 @@ var LLMClient = class {
       },
       body: JSON.stringify(body)
     });
+    if (retryResponse.status === 502 || retryResponse.status === 503) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      const retryResp2 = await this.fetchWithTimeout(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "User-Agent": USER_AGENT,
+          "PAYMENT-SIGNATURE": paymentPayload
+        },
+        body: JSON.stringify(body)
+      });
+      if (retryResp2.status !== 502 && retryResp2.status !== 503) {
+        if (retryResp2.status === 402) throw new PaymentError("Payment was rejected. Check your wallet balance.");
+        if (!retryResp2.ok) {
+          let errorBody;
+          try {
+            errorBody = await retryResp2.json();
+          } catch {
+            errorBody = { error: "Request failed" };
+          }
+          throw new APIError(`API error after payment: ${retryResp2.status}`, retryResp2.status, sanitizeErrorResponse(errorBody));
+        }
+        const costUsd2 = parseFloat(details.amount) / 1e6;
+        this.sessionCalls += 1;
+        this.sessionTotalUsd += costUsd2;
+        return retryResp2.json();
+      }
+    }
     if (retryResponse.status === 402) {
       throw new PaymentError("Payment was rejected. Check your wallet balance.");
     }
@@ -681,6 +834,26 @@ var LLMClient = class {
       method: "GET",
       headers: { "User-Agent": USER_AGENT }
     });
+    if (response.status === 502 || response.status === 503) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      const retryResp = await this.fetchWithTimeout(url, {
+        method: "GET",
+        headers: { "User-Agent": USER_AGENT }
+      });
+      if (retryResp.status !== 502 && retryResp.status !== 503) {
+        if (retryResp.status === 402) return this.handleGetPaymentAndRetryRaw(url, endpoint, params, retryResp);
+        if (!retryResp.ok) {
+          let errorBody;
+          try {
+            errorBody = await retryResp.json();
+          } catch {
+            errorBody = { error: "Request failed" };
+          }
+          throw new APIError(`API error: ${retryResp.status}`, retryResp.status, sanitizeErrorResponse(errorBody));
+        }
+        return retryResp.json();
+      }
+    }
     if (response.status === 402) {
       return this.handleGetPaymentAndRetryRaw(url, endpoint, params, response);
     }
@@ -746,6 +919,32 @@ var LLMClient = class {
         "PAYMENT-SIGNATURE": paymentPayload
       }
     });
+    if (retryResponse.status === 502 || retryResponse.status === 503) {
+      await new Promise((r) => setTimeout(r, 1e3));
+      const retryResp2 = await this.fetchWithTimeout(retryUrl, {
+        method: "GET",
+        headers: {
+          "User-Agent": USER_AGENT,
+          "PAYMENT-SIGNATURE": paymentPayload
+        }
+      });
+      if (retryResp2.status !== 502 && retryResp2.status !== 503) {
+        if (retryResp2.status === 402) throw new PaymentError("Payment was rejected. Check your wallet balance.");
+        if (!retryResp2.ok) {
+          let errorBody;
+          try {
+            errorBody = await retryResp2.json();
+          } catch {
+            errorBody = { error: "Request failed" };
+          }
+          throw new APIError(`API error after payment: ${retryResp2.status}`, retryResp2.status, sanitizeErrorResponse(errorBody));
+        }
+        const costUsd2 = parseFloat(details.amount) / 1e6;
+        this.sessionCalls += 1;
+        this.sessionTotalUsd += costUsd2;
+        return retryResp2.json();
+      }
+    }
     if (retryResponse.status === 402) {
       throw new PaymentError("Payment was rejected. Check your wallet balance.");
     }
@@ -804,7 +1003,18 @@ var LLMClient = class {
       );
     }
     const data = await response.json();
-    return data.data || [];
+    return (data.data || []).map((m) => ({
+      id: m.id,
+      name: m.name || m.id,
+      provider: m.owned_by || "",
+      description: m.description || "",
+      inputPrice: m.pricing?.input ?? m.pricing?.flat ?? 0,
+      outputPrice: m.pricing?.output ?? 0,
+      contextWindow: m.context_window || 0,
+      maxOutput: m.max_output || 0,
+      categories: m.categories || [],
+      available: true
+    }));
   }
   /**
    * List available image generation models with pricing.
@@ -1581,7 +1791,7 @@ import * as os2 from "os";
 var WALLET_DIR2 = path2.join(os2.homedir(), ".blockrun");
 var SOLANA_WALLET_FILE = path2.join(WALLET_DIR2, ".solana-session");
 function createSolanaWallet() {
-  const { Keypair } = (init_index_esm(), __toCommonJS(index_esm_exports));
+  const { Keypair } = __require("@solana/web3.js");
   const bs58 = __require("bs58");
   const keypair = Keypair.generate();
   return {
@@ -1603,7 +1813,7 @@ async function solanaKeyToBytes(privateKey) {
   }
 }
 async function solanaPublicKey(privateKey) {
-  const { Keypair } = await import("./index.esm-SXKIFLA7.js");
+  const { Keypair } = await import("@solana/web3.js");
   const bytes = await solanaKeyToBytes(privateKey);
   return Keypair.fromSecretKey(bytes).publicKey.toBase58();
 }
@@ -2203,6 +2413,8 @@ import * as path3 from "path";
 import * as os3 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 DEFAULT_TTL = {
   "/v1/x/": 3600 * 1e3,
   "/v1/partner/": 3600 * 1e3,
@@ -2267,26 +2479,80 @@ function setCache(key, data, ttlMs) {
   } catch {
   }
 }
-function saveToCache(endpoint, body, response, costUsd = 0) {
-  const ttl = getTtl(endpoint);
-  if (ttl <= 0) return;
+function readableFilename(endpoint, body) {
+  const now = /* @__PURE__ */ new Date();
+  const ts = now.toISOString().slice(0, 10) + "_" + String(now.getHours()).padStart(2, "0") + String(now.getMinutes()).padStart(2, "0") + String(now.getSeconds()).padStart(2, "0");
+  let ep = endpoint.replace(/\/+$/, "").split("/").pop() || "";
+  if (endpoint.includes("/v1/chat/")) {
+    ep = "chat";
+  } else if (endpoint.includes("/v1/x/")) {
+    ep = "x_" + ep;
+  } else if (endpoint.includes("/v1/search")) {
+    ep = "search";
+  } else if (endpoint.includes("/v1/image")) {
+    ep = "image";
+  }
+  let label = body.query || body.username || body.handle || body.model || (typeof body.prompt === "string" ? body.prompt.slice(0, 40) : "") || "";
+  label = String(label).replace(/[^a-zA-Z0-9_\-]/g, "_").slice(0, 40).replace(/^_+|_+$/g, "");
+  return label ? `${ep}_${ts}_${label}.json` : `${ep}_${ts}.json`;
+}
+function saveReadable(endpoint, body, response, costUsd) {
   try {
-    fs3.mkdirSync(CACHE_DIR, { recursive: true });
+    fs3.mkdirSync(DATA_DIR, { recursive: true });
   } catch {
   }
-  const key = cacheKey(endpoint, body);
+  const filename = readableFilename(endpoint, body);
   const entry = {
-    cachedAt: Date.now(),
+    saved_at: (/* @__PURE__ */ new Date()).toISOString(),
     endpoint,
-    body,
-    response,
-    costUsd
+    cost_usd: costUsd,
+    request: body,
+    response
   };
   try {
-    fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+    fs3.writeFileSync(path3.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 });
+  } catch {
+  }
+  const entry = {
+    ts: Date.now() / 1e3,
+    endpoint,
+    cost_usd: costUsd
+  };
+  try {
+    fs3.appendFileSync(COST_LOG_FILE, JSON.stringify(entry) + "\n");
   } catch {
   }
 }
+function saveToCache(endpoint, body, response, costUsd = 0) {
+  const ttl = getTtl(endpoint);
+  if (ttl > 0) {
+    try {
+      fs3.mkdirSync(CACHE_DIR, { recursive: true });
+    } catch {
+    }
+    const key = cacheKey(endpoint, body);
+    const entry = {
+      cachedAt: Date.now(),
+      endpoint,
+      body,
+      response,
+      costUsd
+    };
+    try {
+      fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+    } catch {
+    }
+  }
+  saveReadable(endpoint, body, response, costUsd);
+  appendCostLog(endpoint, costUsd);
+}
 function clearCache() {
   if (!fs3.existsSync(CACHE_DIR)) return 0;
   let count = 0;
@@ -2305,6 +2571,32 @@ function clearCache() {
   }
   return count;
 }
+function getCostLogSummary() {
+  if (!fs3.existsSync(COST_LOG_FILE)) {
+    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();
+    if (!content) return { totalUsd: 0, calls: 0, byEndpoint: {} };
+    for (const line of content.split("\n")) {
+      if (!line) continue;
+      try {
+        const entry = JSON.parse(line);
+        const cost = entry.cost_usd ?? 0;
+        const ep = entry.endpoint ?? "unknown";
+        totalUsd += cost;
+        calls += 1;
+        byEndpoint[ep] = (byEndpoint[ep] || 0) + cost;
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return { totalUsd, calls, byEndpoint };
+}
 
 // src/setup.ts
 function setupAgentWallet(options) {
@@ -2346,27 +2638,27 @@ async function status() {
 import * as fs4 from "fs";
 import * as path4 from "path";
 import * as os4 from "os";
-var DATA_DIR = path4.join(os4.homedir(), ".blockrun", "data");
-var COST_LOG_FILE = path4.join(DATA_DIR, "costs.jsonl");
+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_DIR, { recursive: true });
+    fs4.mkdirSync(DATA_DIR2, { recursive: true });
   } catch {
   }
   try {
-    fs4.appendFileSync(COST_LOG_FILE, JSON.stringify(entry) + "\n");
+    fs4.appendFileSync(COST_LOG_FILE2, JSON.stringify(entry) + "\n");
   } catch {
   }
 }
 function getCostSummary() {
-  if (!fs4.existsSync(COST_LOG_FILE)) {
+  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_FILE, "utf-8").trim();
+    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;
@@ -2667,6 +2959,7 @@ export {
   BASE_CHAIN_ID,
   BlockrunError,
   ImageClient,
+  KNOWN_PROVIDERS,
   LLMClient,
   OpenAI,
   PaymentError,
@@ -2690,6 +2983,7 @@ export {
   formatWalletCreatedMessage,
   getCached,
   getCachedByRequest,
+  getCostLogSummary,
   getCostSummary,
   getEip681Uri,
   getOrCreateSolanaWallet,
@@ -2712,5 +3006,9 @@ export {
   solanaKeyToBytes,
   solanaPublicKey,
   status,
-  testnetClient
+  testnetClient,
+  validateMaxTokens,
+  validateModel,
+  validateTemperature,
+  validateTopP
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "type": "module",
   "description": "BlockRun LLM Gateway SDK - Pay-per-request AI via x402 on Base and Solana",
   "main": "dist/index.cjs",
@@ -18,8 +18,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external @anthropic-ai/sdk",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch --external @anthropic-ai/sdk",
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external @anthropic-ai/sdk --external @solana/web3.js --external @solana/spl-token --external bs58",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch --external @anthropic-ai/sdk --external @solana/web3.js --external @solana/spl-token --external bs58",
     "test": "vitest",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit"
@@ -48,7 +48,7 @@
     "url": "https://github.com/BlockRunAI/blockrun-llm-ts/issues"
   },
   "dependencies": {
-    "@blockrun/clawrouter": "^0.10.18",
+    "@blockrun/clawrouter": "^0.12.71",
     "bs58": "^6.0.0",
     "viem": "^2.21.0"
   },