@blockrun/llm 1.1.0 → 1.3.0

package/dist/index.cjs

@@ -8185,15 +8185,15 @@ function toFailure(result, context, struct59, value) {
   } else if (typeof result === "string") {
     result = { message: result };
   }
-  const { path: path3, branch } = context;
+  const { path: path5, branch } = context;
   const { type: type2 } = struct59;
   const { refinement, message = `Expected a value of type \`${type2}\`${refinement ? ` with refinement \`${refinement}\`` : ""}, but received: \`${print(value)}\`` } = result;
   return {
     value,
     type: type2,
     refinement,
-    key: path3[path3.length - 1],
-    path: path3,
+    key: path5[path5.length - 1],
+    path: path5,
     branch,
     ...result,
     message
@@ -8211,20 +8211,20 @@ function* toFailures(result, context, struct59, value) {
   }
 }
 function* run(value, struct59, options = {}) {
-  const { path: path3 = [], branch = [value], coerce: coerce2 = false, mask: mask2 = false } = options;
-  const ctx = { path: path3, branch, mask: mask2 };
+  const { path: path5 = [], branch = [value], coerce: coerce2 = false, mask: mask2 = false } = options;
+  const ctx = { path: path5, branch, mask: mask2 };
   if (coerce2) {
     value = struct59.coercer(value, ctx);
   }
-  let status = "valid";
+  let status2 = "valid";
   for (const failure of struct59.validator(value, ctx)) {
     failure.explanation = options.message;
-    status = "not_valid";
+    status2 = "not_valid";
     yield [failure, void 0];
   }
   for (let [k, v, s] of struct59.entries(value, ctx)) {
     const ts = run(v, s, {
-      path: k === void 0 ? path3 : [...path3, k],
+      path: k === void 0 ? path5 : [...path5, k],
       branch: k === void 0 ? branch : [...branch, v],
       coerce: coerce2,
       mask: mask2,
@@ -8232,7 +8232,7 @@ function* run(value, struct59, options = {}) {
     });
     for (const t of ts) {
       if (t[0]) {
-        status = t[0].refinement != null ? "not_refined" : "not_valid";
+        status2 = t[0].refinement != null ? "not_refined" : "not_valid";
         yield [t[0], void 0];
       } else if (coerce2) {
         v = t[1];
@@ -8249,14 +8249,14 @@ function* run(value, struct59, options = {}) {
       }
     }
   }
-  if (status !== "not_valid") {
+  if (status2 !== "not_valid") {
     for (const failure of struct59.refiner(value, ctx)) {
       failure.explanation = options.message;
-      status = "not_refined";
+      status2 = "not_refined";
       yield [failure, void 0];
     }
   }
-  if (status === "valid") {
+  if (status2 === "valid") {
     yield [void 0, value];
   }
 }
@@ -8496,8 +8496,8 @@ var init_dist = __esm({
       constructor(failure, failures) {
         let cached;
         const { message, explanation, ...rest } = failure;
-        const { path: path3 } = failure;
-        const msg = path3.length === 0 ? message : `At path: ${path3.join(".")} -- ${message}`;
+        const { path: path5 } = failure;
+        const msg = path5.length === 0 ? message : `At path: ${path5.join(".")} -- ${message}`;
         super(explanation ?? msg);
         if (explanation != null)
           this.cause = msg;
@@ -9296,8 +9296,8 @@ var require_tr46 = __commonJS({
       var len = countSymbols(domain_name);
       for (var i = 0; i < len; ++i) {
         var codePoint = domain_name.codePointAt(i);
-        var status = findStatus(codePoint);
-        switch (status[1]) {
+        var status2 = findStatus(codePoint);
+        switch (status2[1]) {
           case "disallowed":
             hasError = true;
             processed += String.fromCodePoint(codePoint);
@@ -9305,11 +9305,11 @@ var require_tr46 = __commonJS({
           case "ignored":
             break;
           case "mapped":
-            processed += String.fromCodePoint.apply(String, status[2]);
+            processed += String.fromCodePoint.apply(String, status2[2]);
             break;
           case "deviation":
             if (processing_option === PROCESSING_OPTIONS.TRANSITIONAL) {
-              processed += String.fromCodePoint.apply(String, status[2]);
+              processed += String.fromCodePoint.apply(String, status2[2]);
             } else {
               processed += String.fromCodePoint(codePoint);
             }
@@ -9322,7 +9322,7 @@ var require_tr46 = __commonJS({
               hasError = true;
               processed += String.fromCodePoint(codePoint);
             } else {
-              processed += String.fromCodePoint.apply(String, status[2]);
+              processed += String.fromCodePoint.apply(String, status2[2]);
             }
             break;
           case "disallowed_STD3_valid":
@@ -9350,8 +9350,8 @@ var require_tr46 = __commonJS({
       }
       var len = countSymbols(label);
       for (var i = 0; i < len; ++i) {
-        var status = findStatus(label.codePointAt(i));
-        if (processing === PROCESSING_OPTIONS.TRANSITIONAL && status[1] !== "valid" || processing === PROCESSING_OPTIONS.NONTRANSITIONAL && status[1] !== "valid" && status[1] !== "deviation") {
+        var status2 = findStatus(label.codePointAt(i));
+        if (processing === PROCESSING_OPTIONS.TRANSITIONAL && status2[1] !== "valid" || processing === PROCESSING_OPTIONS.NONTRANSITIONAL && status2[1] !== "valid" && status2[1] !== "deviation") {
           error = true;
           break;
         }
@@ -9806,14 +9806,14 @@ var require_url_state_machine = __commonJS({
       return url2.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url2) {
-      const path3 = url2.path;
-      if (path3.length === 0) {
+      const path5 = url2.path;
+      if (path5.length === 0) {
         return;
       }
-      if (url2.scheme === "file" && path3.length === 1 && isNormalizedWindowsDriveLetter(path3[0])) {
+      if (url2.scheme === "file" && path5.length === 1 && isNormalizedWindowsDriveLetter(path5[0])) {
         return;
       }
-      path3.pop();
+      path5.pop();
     }
     function includesCredentials(url2) {
       return url2.username !== "" || url2.password !== "";
@@ -11887,7 +11887,7 @@ var init_lib = __esm({
         let body = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : null;
         let opts = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         Body.call(this, body, opts);
-        const status = opts.status || 200;
+        const status2 = opts.status || 200;
         const headers = new Headers(opts.headers);
         if (body != null && !headers.has("Content-Type")) {
           const contentType = extractContentType(body);
@@ -11897,8 +11897,8 @@ var init_lib = __esm({
         }
         this[INTERNALS$1] = {
           url: opts.url,
-          status,
-          statusText: opts.statusText || STATUS_CODES[status],
+          status: status2,
+          statusText: opts.statusText || STATUS_CODES[status2],
           headers,
           counter: opts.counter
         };
@@ -12098,16 +12098,16 @@ var require_constants = __commonJS({
 var require_node_gyp_build = __commonJS({
   "node_modules/.pnpm/node-gyp-build@4.8.4/node_modules/node-gyp-build/node-gyp-build.js"(exports2, module2) {
     "use strict";
-    var fs3 = require("fs");
-    var path3 = require("path");
-    var os3 = require("os");
+    var fs5 = require("fs");
+    var path5 = require("path");
+    var os5 = require("os");
     var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : require;
     var vars = process.config && process.config.variables || {};
     var prebuildsOnly = !!process.env.PREBUILDS_ONLY;
     var abi = process.versions.modules;
     var runtime = isElectron() ? "electron" : isNwjs() ? "node-webkit" : "node";
-    var arch = process.env.npm_config_arch || os3.arch();
-    var platform = process.env.npm_config_platform || os3.platform();
+    var arch = process.env.npm_config_arch || os5.arch();
+    var platform = process.env.npm_config_platform || os5.platform();
     var libc = process.env.LIBC || (isAlpine(platform) ? "musl" : "glibc");
     var armv = process.env.ARM_VERSION || (arch === "arm64" ? "8" : vars.arm_version) || "";
     var uv = (process.versions.uv || "").split(".")[0];
@@ -12116,21 +12116,21 @@ var require_node_gyp_build = __commonJS({
       return runtimeRequire(load.resolve(dir));
     }
     load.resolve = load.path = function(dir) {
-      dir = path3.resolve(dir || ".");
+      dir = path5.resolve(dir || ".");
       try {
-        var name = runtimeRequire(path3.join(dir, "package.json")).name.toUpperCase().replace(/-/g, "_");
+        var name = runtimeRequire(path5.join(dir, "package.json")).name.toUpperCase().replace(/-/g, "_");
         if (process.env[name + "_PREBUILD"]) dir = process.env[name + "_PREBUILD"];
       } catch (err) {
       }
       if (!prebuildsOnly) {
-        var release = getFirst(path3.join(dir, "build/Release"), matchBuild);
+        var release = getFirst(path5.join(dir, "build/Release"), matchBuild);
         if (release) return release;
-        var debug = getFirst(path3.join(dir, "build/Debug"), matchBuild);
+        var debug = getFirst(path5.join(dir, "build/Debug"), matchBuild);
         if (debug) return debug;
       }
       var prebuild = resolve(dir);
       if (prebuild) return prebuild;
-      var nearby = resolve(path3.dirname(process.execPath));
+      var nearby = resolve(path5.dirname(process.execPath));
       if (nearby) return nearby;
       var target = [
         "platform=" + platform,
@@ -12147,26 +12147,26 @@ var require_node_gyp_build = __commonJS({
       ].filter(Boolean).join(" ");
       throw new Error("No native build was found for " + target + "\n    loaded from: " + dir + "\n");
       function resolve(dir2) {
-        var tuples = readdirSync(path3.join(dir2, "prebuilds")).map(parseTuple);
+        var tuples = readdirSync4(path5.join(dir2, "prebuilds")).map(parseTuple);
         var tuple2 = tuples.filter(matchTuple(platform, arch)).sort(compareTuples)[0];
         if (!tuple2) return;
-        var prebuilds = path3.join(dir2, "prebuilds", tuple2.name);
-        var parsed = readdirSync(prebuilds).map(parseTags);
+        var prebuilds = path5.join(dir2, "prebuilds", tuple2.name);
+        var parsed = readdirSync4(prebuilds).map(parseTags);
         var candidates = parsed.filter(matchTags(runtime, abi));
         var winner = candidates.sort(compareTags(runtime))[0];
-        if (winner) return path3.join(prebuilds, winner.file);
+        if (winner) return path5.join(prebuilds, winner.file);
       }
     };
-    function readdirSync(dir) {
+    function readdirSync4(dir) {
       try {
-        return fs3.readdirSync(dir);
+        return fs5.readdirSync(dir);
       } catch (err) {
         return [];
       }
     }
     function getFirst(dir, filter) {
-      var files = readdirSync(dir).filter(filter);
-      return files[0] && path3.join(dir, files[0]);
+      var files = readdirSync4(dir).filter(filter);
+      return files[0] && path5.join(dir, files[0]);
     }
     function matchBuild(name) {
       return /\.node$/.test(name);
@@ -12253,7 +12253,7 @@ var require_node_gyp_build = __commonJS({
       return typeof window !== "undefined" && window.process && window.process.type === "renderer";
     }
     function isAlpine(platform2) {
-      return platform2 === "linux" && fs3.existsSync("/etc/alpine-release");
+      return platform2 === "linux" && fs5.existsSync("/etc/alpine-release");
     }
     load.parseTags = parseTags;
     load.matchTags = matchTags;
@@ -14537,7 +14537,7 @@ var require_websocket = __commonJS({
     var http2 = require("http");
     var net = require("net");
     var tls = require("tls");
-    var { randomBytes: randomBytes2, createHash } = require("crypto");
+    var { randomBytes: randomBytes2, createHash: createHash2 } = require("crypto");
     var { Duplex, Readable: Readable2 } = require("stream");
     var { URL: URL4 } = require("url");
     var PerMessageDeflate = require_permessage_deflate();
@@ -15197,7 +15197,7 @@ var require_websocket = __commonJS({
           abortHandshake(websocket, socket, "Invalid Upgrade header");
           return;
         }
-        const digest = createHash("sha1").update(key + GUID).digest("base64");
+        const digest = createHash2("sha1").update(key + GUID).digest("base64");
         if (res.headers["sec-websocket-accept"] !== digest) {
           abortHandshake(websocket, socket, "Invalid Sec-WebSocket-Accept header");
           return;
@@ -15564,7 +15564,7 @@ var require_websocket_server = __commonJS({
     var EventEmitter2 = require("events");
     var http2 = require("http");
     var { Duplex } = require("stream");
-    var { createHash } = require("crypto");
+    var { createHash: createHash2 } = require("crypto");
     var extension = require_extension();
     var PerMessageDeflate = require_permessage_deflate();
     var subprotocol = require_subprotocol();
@@ -15865,7 +15865,7 @@ var require_websocket_server = __commonJS({
           );
         }
         if (this._state > RUNNING) return abortHandshake(socket, 503);
-        const digest = createHash("sha1").update(key + GUID).digest("base64");
+        const digest = createHash2("sha1").update(key + GUID).digest("base64");
         const headers = [
           "HTTP/1.1 101 Switching Protocols",
           "Upgrade: websocket",
@@ -18001,9 +18001,9 @@ async function sendAndConfirmTransaction(connection, transaction, signers, optio
     minContextSlot: options.minContextSlot
   };
   const signature2 = await connection.sendTransaction(transaction, signers, sendOptions);
-  let status;
+  let status2;
   if (transaction.recentBlockhash != null && transaction.lastValidBlockHeight != null) {
-    status = (await connection.confirmTransaction({
+    status2 = (await connection.confirmTransaction({
       abortSignal: options?.abortSignal,
       signature: signature2,
       blockhash: transaction.recentBlockhash,
@@ -18014,7 +18014,7 @@ async function sendAndConfirmTransaction(connection, transaction, signers, optio
       nonceInstruction
     } = transaction.nonceInfo;
     const nonceAccountPubkey = nonceInstruction.keys[0].pubkey;
-    status = (await connection.confirmTransaction({
+    status2 = (await connection.confirmTransaction({
       abortSignal: options?.abortSignal,
       minContextSlot: transaction.minNonceContextSlot,
       nonceAccountPubkey,
@@ -18025,17 +18025,17 @@ async function sendAndConfirmTransaction(connection, transaction, signers, optio
     if (options?.abortSignal != null) {
       console.warn("sendAndConfirmTransaction(): A transaction with a deprecated confirmation strategy was supplied along with an `abortSignal`. Only transactions having `lastValidBlockHeight` or a combination of `nonceInfo` and `minNonceContextSlot` are abortable.");
     }
-    status = (await connection.confirmTransaction(signature2, options && options.commitment)).value;
+    status2 = (await connection.confirmTransaction(signature2, options && options.commitment)).value;
   }
-  if (status.err) {
+  if (status2.err) {
     if (signature2 != null) {
       throw new SendTransactionError({
         action: "send",
         signature: signature2,
-        transactionMessage: `Status: (${JSON.stringify(status)})`
+        transactionMessage: `Status: (${JSON.stringify(status2)})`
       });
     }
-    throw new Error(`Transaction ${signature2} failed (${JSON.stringify(status)})`);
+    throw new Error(`Transaction ${signature2} failed (${JSON.stringify(status2)})`);
   }
   return signature2;
 }
@@ -19011,16 +19011,16 @@ async function sendAndConfirmRawTransaction(connection, rawTransaction, confirma
   const signature2 = await connection.sendRawTransaction(rawTransaction, sendOptions);
   const commitment = options && options.commitment;
   const confirmationPromise = confirmationStrategy ? connection.confirmTransaction(confirmationStrategy, commitment) : connection.confirmTransaction(signature2, commitment);
-  const status = (await confirmationPromise).value;
-  if (status.err) {
+  const status2 = (await confirmationPromise).value;
+  if (status2.err) {
     if (signature2 != null) {
       throw new SendTransactionError({
         action: sendOptions?.skipPreflight ? "send" : "simulate",
         signature: signature2,
-        transactionMessage: `Status: (${JSON.stringify(status)})`
+        transactionMessage: `Status: (${JSON.stringify(status2)})`
       });
     }
-    throw new Error(`Raw transaction ${signature2} failed (${JSON.stringify(status)})`);
+    throw new Error(`Raw transaction ${signature2} failed (${JSON.stringify(status2)})`);
   }
   return signature2;
 }
@@ -23087,15 +23087,15 @@ Message: ${transactionMessage}.
           } else {
             let signatureStatus;
             while (true) {
-              const status = await this.getSignatureStatus(signature2);
-              if (status == null) {
+              const status2 = await this.getSignatureStatus(signature2);
+              if (status2 == null) {
                 break;
               }
-              if (status.context.slot < (outcome.slotInWhichNonceDidAdvance ?? minContextSlot)) {
+              if (status2.context.slot < (outcome.slotInWhichNonceDidAdvance ?? minContextSlot)) {
                 await sleep(400);
                 continue;
               }
-              signatureStatus = status;
+              signatureStatus = status2;
               break;
             }
             if (signatureStatus?.value) {
@@ -27011,20 +27011,20 @@ var require_file_uri_to_path = __commonJS({
       var rest = decodeURI(uri.substring(7));
       var firstSlash = rest.indexOf("/");
       var host = rest.substring(0, firstSlash);
-      var path3 = rest.substring(firstSlash + 1);
+      var path5 = rest.substring(firstSlash + 1);
       if ("localhost" == host) host = "";
       if (host) {
         host = sep + sep + host;
       }
-      path3 = path3.replace(/^(.+)\|/, "$1:");
+      path5 = path5.replace(/^(.+)\|/, "$1:");
       if (sep == "\\") {
-        path3 = path3.replace(/\//g, "\\");
+        path5 = path5.replace(/\//g, "\\");
       }
-      if (/^.+\:/.test(path3)) {
+      if (/^.+\:/.test(path5)) {
       } else {
-        path3 = sep + path3;
+        path5 = sep + path5;
       }
-      return host + path3;
+      return host + path5;
     }
   }
 });
@@ -27033,19 +27033,19 @@ var require_file_uri_to_path = __commonJS({
 var require_bindings = __commonJS({
   "node_modules/.pnpm/bindings@1.5.0/node_modules/bindings/bindings.js"(exports2, module2) {
     "use strict";
-    var fs3 = require("fs");
-    var path3 = require("path");
+    var fs5 = require("fs");
+    var path5 = require("path");
     var fileURLToPath = require_file_uri_to_path();
-    var join3 = path3.join;
-    var dirname = path3.dirname;
-    var exists = fs3.accessSync && function(path4) {
+    var join5 = path5.join;
+    var dirname = path5.dirname;
+    var exists = fs5.accessSync && function(path6) {
       try {
-        fs3.accessSync(path4);
+        fs5.accessSync(path6);
       } catch (e2) {
         return false;
       }
       return true;
-    } || fs3.existsSync || path3.existsSync;
+    } || fs5.existsSync || path5.existsSync;
     var defaults = {
       arrow: process.env.NODE_BINDINGS_ARROW || " \u2192 ",
       compiled: process.env.NODE_BINDINGS_COMPILED_DIR || "compiled",
@@ -27090,13 +27090,13 @@ var require_bindings = __commonJS({
       if (!opts.module_root) {
         opts.module_root = exports2.getRoot(exports2.getFileName());
       }
-      if (path3.extname(opts.bindings) != ".node") {
+      if (path5.extname(opts.bindings) != ".node") {
         opts.bindings += ".node";
       }
       var requireFunc = typeof __webpack_require__ === "function" ? __non_webpack_require__ : require;
       var tries = [], i = 0, l = opts.try.length, n, b, err;
       for (; i < l; i++) {
-        n = join3.apply(
+        n = join5.apply(
           null,
           opts.try[i].map(function(p) {
             return opts[p] || p;
@@ -27157,7 +27157,7 @@ var require_bindings = __commonJS({
         if (dir === ".") {
           dir = process.cwd();
         }
-        if (exists(join3(dir, "package.json")) || exists(join3(dir, "node_modules"))) {
+        if (exists(join5(dir, "package.json")) || exists(join5(dir, "node_modules"))) {
           return dir;
         }
         if (prev === dir) {
@@ -27166,7 +27166,7 @@ var require_bindings = __commonJS({
           );
         }
         prev = dir;
-        dir = join3(dir, "..");
+        dir = join5(dir, "..");
       }
     };
   }
@@ -36434,6 +36434,7 @@ __export(index_exports, {
   USDC_SOLANA: () => USDC_SOLANA,
   WALLET_DIR_PATH: () => WALLET_DIR_PATH,
   WALLET_FILE_PATH: () => WALLET_FILE_PATH,
+  clearCache: () => clearCache,
   createSolanaPaymentPayload: () => createSolanaPaymentPayload,
   createSolanaWallet: () => createSolanaWallet,
   createWallet: () => createWallet,
@@ -36441,6 +36442,9 @@ __export(index_exports, {
   formatFundingMessageCompact: () => formatFundingMessageCompact,
   formatNeedsFundingMessage: () => formatNeedsFundingMessage,
   formatWalletCreatedMessage: () => formatWalletCreatedMessage,
+  getCached: () => getCached,
+  getCachedByRequest: () => getCachedByRequest,
+  getCostSummary: () => getCostSummary,
   getEip681Uri: () => getEip681Uri,
   getOrCreateSolanaWallet: () => getOrCreateSolanaWallet,
   getOrCreateWallet: () => getOrCreateWallet,
@@ -36448,11 +36452,19 @@ __export(index_exports, {
   getWalletAddress: () => getWalletAddress,
   loadSolanaWallet: () => loadSolanaWallet,
   loadWallet: () => loadWallet,
+  logCost: () => logCost,
   saveSolanaWallet: () => saveSolanaWallet,
+  saveToCache: () => saveToCache,
   saveWallet: () => saveWallet,
+  scanSolanaWallets: () => scanSolanaWallets,
+  scanWallets: () => scanWallets,
+  setCache: () => setCache,
+  setupAgentSolanaWallet: () => setupAgentSolanaWallet,
+  setupAgentWallet: () => setupAgentWallet,
   solanaClient: () => solanaClient,
   solanaKeyToBytes: () => solanaKeyToBytes,
   solanaPublicKey: () => solanaPublicKey,
+  status: () => status,
   testnetClient: () => testnetClient
 });
 module.exports = __toCommonJS(index_exports);
@@ -37025,6 +37037,200 @@ var LLMClient = class {
     this.sessionTotalUsd += costUsd;
     return retryResponse.json();
   }
+  /**
+   * Make a request with automatic x402 payment handling, returning raw JSON.
+   * Used for non-ChatResponse endpoints (X/Twitter, search, image edit, etc.).
+   */
+  async requestWithPaymentRaw(endpoint2, body) {
+    const url2 = `${this.apiUrl}${endpoint2}`;
+    const response = await this.fetchWithTimeout(url2, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetryRaw(url2, 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();
+  }
+  /**
+   * Handle 402 response for raw endpoints: parse requirements, sign payment, retry.
+   */
+  async handlePaymentAndRetryRaw(url2, 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 {
+        console.debug("Failed to parse payment header from response body");
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url2,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url2, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT,
+        "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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
+  /**
+   * GET with automatic x402 payment handling, returning raw JSON.
+   * Used for Predexon prediction market endpoints that use GET + query params.
+   */
+  async getWithPaymentRaw(endpoint2, params) {
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const url2 = `${this.apiUrl}${endpoint2}${query}`;
+    const response = await this.fetchWithTimeout(url2, {
+      method: "GET",
+      headers: { "User-Agent": USER_AGENT }
+    });
+    if (response.status === 402) {
+      return this.handleGetPaymentAndRetryRaw(url2, endpoint2, params, 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();
+  }
+  /**
+   * Handle 402 response for GET endpoints: parse requirements, sign payment, retry with GET.
+   */
+  async handleGetPaymentAndRetryRaw(url2, endpoint2, params, 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 {
+        console.debug("Failed to parse payment header from response body");
+      }
+    }
+    if (!paymentHeader) {
+      throw new PaymentError("402 response but no payment requirements found");
+    }
+    const paymentRequired = parsePaymentRequired(paymentHeader);
+    const details = extractPaymentDetails(paymentRequired);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url2,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions
+      }
+    );
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const retryUrl = `${this.apiUrl}${endpoint2}${query}`;
+    const retryResponse = await this.fetchWithTimeout(retryUrl, {
+      method: "GET",
+      headers: {
+        "User-Agent": USER_AGENT,
+        "PAYMENT-SIGNATURE": paymentPayload
+      }
+    });
+    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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
   /**
    * Fetch with timeout.
    */
@@ -37107,6 +37313,317 @@ var LLMClient = class {
     }
     return [...llmModels, ...imageModels];
   }
+  /**
+   * Edit an image using img2img.
+   *
+   * @param prompt - Text description of the desired edit
+   * @param image - Base64-encoded image or URL of the source image
+   * @param options - Optional edit parameters
+   * @returns ImageResponse with edited image URLs
+   */
+  async imageEdit(prompt, image, options) {
+    const body = {
+      model: options?.model || "openai/gpt-image-1",
+      prompt,
+      image,
+      size: options?.size || "1024x1024",
+      n: options?.n || 1
+    };
+    if (options?.mask !== void 0) {
+      body.mask = options.mask;
+    }
+    const data = await this.requestWithPaymentRaw("/v1/images/image2image", body);
+    return data;
+  }
+  /**
+   * Standalone search (web, X/Twitter, news).
+   *
+   * @param query - Search query
+   * @param options - Optional search parameters
+   * @returns SearchResult with summary and citations
+   */
+  async search(query, options) {
+    const body = {
+      query,
+      max_results: options?.maxResults || 10
+    };
+    if (options?.sources !== void 0) body.sources = options.sources;
+    if (options?.fromDate !== void 0) body.from_date = options.fromDate;
+    if (options?.toDate !== void 0) body.to_date = options.toDate;
+    const data = await this.requestWithPaymentRaw("/v1/search", body);
+    return data;
+  }
+  /**
+   * Get USDC balance on Base network.
+   *
+   * Automatically detects mainnet vs testnet based on API URL.
+   *
+   * @returns USDC balance as a float (6 decimal places normalized)
+   *
+   * @example
+   * const balance = await client.getBalance();
+   * 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 selector = "0x70a08231";
+    const paddedAddress = this.account.address.slice(2).toLowerCase().padStart(64, "0");
+    const data = selector + paddedAddress;
+    const payload = {
+      jsonrpc: "2.0",
+      method: "eth_call",
+      params: [{ to: usdcContract, data }, "latest"],
+      id: 1
+    };
+    let lastError;
+    for (const rpc of rpcs) {
+      try {
+        const response = await fetch(rpc, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload)
+        });
+        const result = await response.json();
+        const balanceRaw = parseInt(result.result || "0x0", 16);
+        return balanceRaw / 1e6;
+      } catch (e2) {
+        lastError = e2;
+      }
+    }
+    throw lastError || new Error("All RPCs failed");
+  }
+  // ============================================================
+  // X/Twitter endpoints (powered by AttentionVC)
+  // ============================================================
+  /**
+   * Look up X/Twitter user profiles by username.
+   *
+   * Powered by AttentionVC. $0.002 per user (min $0.02, max $0.20).
+   *
+   * @param usernames - Single username or array of usernames (without @)
+   */
+  async xUserLookup(usernames) {
+    const names = Array.isArray(usernames) ? usernames : [usernames];
+    const data = await this.requestWithPaymentRaw("/v1/x/users/lookup", { usernames: names });
+    return data;
+  }
+  /**
+   * Get followers of an X/Twitter user.
+   *
+   * Powered by AttentionVC. $0.05 per page (~200 accounts).
+   *
+   * @param username - X/Twitter username (without @)
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xFollowers(username, cursor) {
+    const body = { username };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/followers", body);
+    return data;
+  }
+  /**
+   * Get accounts an X/Twitter user is following.
+   *
+   * Powered by AttentionVC. $0.05 per page (~200 accounts).
+   *
+   * @param username - X/Twitter username (without @)
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xFollowings(username, cursor) {
+    const body = { username };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/followings", body);
+    return data;
+  }
+  /**
+   * Get detailed profile info for a single X/Twitter user.
+   *
+   * Powered by AttentionVC. $0.002 per request.
+   *
+   * @param username - X/Twitter username (without @)
+   */
+  async xUserInfo(username) {
+    const data = await this.requestWithPaymentRaw("/v1/x/users/info", { username });
+    return data;
+  }
+  /**
+   * Get verified (blue-check) followers of an X/Twitter user.
+   *
+   * Powered by AttentionVC. $0.048 per page.
+   *
+   * @param userId - X/Twitter user ID (not username)
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xVerifiedFollowers(userId, cursor) {
+    const body = { userId };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/verified-followers", body);
+    return data;
+  }
+  /**
+   * Get tweets posted by an X/Twitter user.
+   *
+   * Powered by AttentionVC. $0.032 per page.
+   *
+   * @param username - X/Twitter username (without @)
+   * @param includeReplies - Include reply tweets (default: false)
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xUserTweets(username, includeReplies = false, cursor) {
+    const body = { username, includeReplies };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/tweets", body);
+    return data;
+  }
+  /**
+   * Get tweets that mention an X/Twitter user.
+   *
+   * Powered by AttentionVC. $0.032 per page.
+   *
+   * @param username - X/Twitter username (without @)
+   * @param sinceTime - Start time filter (ISO8601 or Unix timestamp)
+   * @param untilTime - End time filter (ISO8601 or Unix timestamp)
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xUserMentions(username, sinceTime, untilTime, cursor) {
+    const body = { username };
+    if (sinceTime !== void 0) body.sinceTime = sinceTime;
+    if (untilTime !== void 0) body.untilTime = untilTime;
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/mentions", body);
+    return data;
+  }
+  /**
+   * Fetch full tweet data for up to 200 tweet IDs.
+   *
+   * Powered by AttentionVC. $0.16 per batch.
+   *
+   * @param tweetIds - Single tweet ID or array of tweet IDs (max 200)
+   */
+  async xTweetLookup(tweetIds) {
+    const ids = Array.isArray(tweetIds) ? tweetIds : [tweetIds];
+    const data = await this.requestWithPaymentRaw("/v1/x/tweets/lookup", { tweet_ids: ids });
+    return data;
+  }
+  /**
+   * Get replies to a specific tweet.
+   *
+   * Powered by AttentionVC. $0.032 per page.
+   *
+   * @param tweetId - The tweet ID to get replies for
+   * @param queryType - Sort order: 'Latest' or 'Default'
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xTweetReplies(tweetId, queryType = "Latest", cursor) {
+    const body = { tweetId, queryType };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/tweets/replies", body);
+    return data;
+  }
+  /**
+   * Get the full thread context for a tweet.
+   *
+   * Powered by AttentionVC. $0.032 per page.
+   *
+   * @param tweetId - The tweet ID to get thread for
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xTweetThread(tweetId, cursor) {
+    const body = { tweetId };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/tweets/thread", body);
+    return data;
+  }
+  /**
+   * Search X/Twitter with advanced query operators.
+   *
+   * Powered by AttentionVC. $0.032 per page.
+   *
+   * @param query - Search query (supports Twitter search operators)
+   * @param queryType - Sort order: 'Latest', 'Top', or 'Default'
+   * @param cursor - Pagination cursor from previous response
+   */
+  async xSearch(query, queryType = "Latest", cursor) {
+    const body = { query, queryType };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/search", body);
+    return data;
+  }
+  /**
+   * Get current trending topics on X/Twitter.
+   *
+   * Powered by AttentionVC. $0.002 per request.
+   */
+  async xTrending() {
+    const data = await this.requestWithPaymentRaw("/v1/x/trending", {});
+    return data;
+  }
+  /**
+   * Get rising/viral articles from X/Twitter.
+   *
+   * Powered by AttentionVC intelligence layer. $0.05 per request.
+   */
+  async xArticlesRising() {
+    const data = await this.requestWithPaymentRaw("/v1/x/articles/rising", {});
+    return data;
+  }
+  /**
+   * Get author analytics and intelligence metrics for an X/Twitter user.
+   *
+   * Powered by AttentionVC intelligence layer. $0.02 per request.
+   *
+   * @param handle - X/Twitter handle (without @)
+   */
+  async xAuthorAnalytics(handle) {
+    const data = await this.requestWithPaymentRaw("/v1/x/authors", { handle });
+    return data;
+  }
+  /**
+   * Compare two X/Twitter authors side-by-side with intelligence metrics.
+   *
+   * Powered by AttentionVC intelligence layer. $0.05 per request.
+   *
+   * @param handle1 - First X/Twitter handle (without @)
+   * @param handle2 - Second X/Twitter handle (without @)
+   */
+  async xCompareAuthors(handle1, handle2) {
+    const data = await this.requestWithPaymentRaw("/v1/x/compare", { handle1, handle2 });
+    return data;
+  }
+  // ── Prediction Markets (Powered by Predexon) ────────────────────────────
+  /**
+   * Query Predexon prediction market data (GET endpoints).
+   *
+   * Access real-time data from Polymarket, Kalshi, dFlow, and Binance Futures.
+   * Powered by Predexon. $0.001 per request.
+   *
+   * @param path - Endpoint path, e.g. "polymarket/events", "kalshi/markets/12345"
+   * @param params - Query parameters passed to the endpoint
+   *
+   * @example
+   * const events = await client.pm("polymarket/events");
+   * const market = await client.pm("kalshi/markets/KXBTC-25MAR14");
+   * const results = await client.pm("polymarket/search", { q: "bitcoin" });
+   */
+  async pm(path5, params) {
+    return this.getWithPaymentRaw(`/v1/pm/${path5}`, params);
+  }
+  /**
+   * Structured query for Predexon prediction market data (POST endpoints).
+   *
+   * For complex queries that require a JSON body. $0.005 per request.
+   *
+   * @param path - Endpoint path, e.g. "polymarket/query", "kalshi/query"
+   * @param query - JSON body for the structured query
+   *
+   * @example
+   * const data = await client.pmQuery("polymarket/query", { filter: "active", limit: 10 });
+   */
+  async pmQuery(path5, query) {
+    return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
+  }
   /**
    * Get current session spending.
    *
@@ -37200,6 +37717,31 @@ var ImageClient = class {
     }
     return this.requestWithPayment("/v1/images/generations", body);
   }
+  /**
+   * Edit an image using img2img.
+   *
+   * @param prompt - Text description of the desired edit
+   * @param image - Base64-encoded image or URL of the source image
+   * @param options - Optional edit parameters
+   * @returns ImageResponse with edited image URLs
+   *
+   * @example
+   * const result = await client.edit('Make it a painting', imageBase64);
+   * console.log(result.data[0].url);
+   */
+  async edit(prompt, image, options) {
+    const body = {
+      model: options?.model || "openai/gpt-image-1",
+      prompt,
+      image,
+      size: options?.size || "1024x1024",
+      n: options?.n || 1
+    };
+    if (options?.mask !== void 0) {
+      body.mask = options.mask;
+    }
+    return this.requestWithPayment("/v1/images/image2image", body);
+  }
   /**
    * List available image generation models with pricing.
    */
@@ -37367,7 +37909,35 @@ function saveWallet(privateKey) {
   fs.writeFileSync(WALLET_FILE, privateKey, { mode: 384 });
   return WALLET_FILE;
 }
+function scanWallets() {
+  const home = os.homedir();
+  const results = [];
+  try {
+    const entries = fs.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;
+      try {
+        const data = JSON.parse(fs.readFileSync(walletFile, "utf-8"));
+        const pk = data.privateKey || "";
+        const addr = data.address || "";
+        if (pk && addr) {
+          const mtime = fs.statSync(walletFile).mtimeMs;
+          results.push({ mtime, privateKey: pk, address: addr });
+        }
+      } catch {
+        continue;
+      }
+    }
+  } catch {
+  }
+  results.sort((a, b) => b.mtime - a.mtime);
+  return results.map(({ privateKey, address }) => ({ privateKey, address }));
+}
 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 (key) return key;
@@ -37506,7 +38076,50 @@ function saveSolanaWallet(privateKey) {
   fs2.writeFileSync(SOLANA_WALLET_FILE, privateKey, { mode: 384 });
   return SOLANA_WALLET_FILE;
 }
+function scanSolanaWallets() {
+  const home = os2.homedir();
+  const results = [];
+  try {
+    const entries = fs2.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)) {
+        try {
+          const data = JSON.parse(fs2.readFileSync(solanaWalletFile, "utf-8"));
+          const pk = data.privateKey || "";
+          const addr = data.address || "";
+          if (pk && addr) {
+            const mtime = fs2.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)) {
+          try {
+            const data = JSON.parse(fs2.readFileSync(brccWalletFile, "utf-8"));
+            const pk = data.privateKey || "";
+            const addr = data.address || "";
+            if (pk && addr) {
+              const mtime = fs2.statSync(brccWalletFile).mtimeMs;
+              results.push({ mtime, secretKey: pk, publicKey: addr });
+            }
+          } catch {
+          }
+        }
+      }
+    }
+  } catch {
+  }
+  results.sort((a, b) => b.mtime - a.mtime);
+  return results.map(({ secretKey, publicKey: publicKey3 }) => ({ secretKey, publicKey: publicKey3 }));
+}
 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 (key) return key;
@@ -37519,10 +38132,16 @@ async function getOrCreateSolanaWallet() {
     const address2 = await solanaPublicKey(envKey);
     return { privateKey: envKey, address: address2, isNew: false };
   }
-  const fileKey = loadSolanaWallet();
-  if (fileKey) {
-    const address2 = await solanaPublicKey(fileKey);
-    return { privateKey: fileKey, address: address2, isNew: false };
+  const wallets = scanSolanaWallets();
+  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 (fileKey) {
+      const address2 = await solanaPublicKey(fileKey);
+      return { privateKey: fileKey, address: address2, isNew: false };
+    }
   }
   const { address, privateKey } = createSolanaWallet();
   saveSolanaWallet(privateKey);
@@ -37580,29 +38199,172 @@ var SolanaLLMClient = class {
     });
     return result.choices[0].message.content || "";
   }
-  /** Full chat completion (OpenAI-compatible). */
-  async chatCompletion(model, messages, options) {
-    const body = {
-      model,
-      messages,
-      max_tokens: options?.maxTokens || DEFAULT_MAX_TOKENS2
-    };
-    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 this.requestWithPayment("/v1/chat/completions", body);
+  /** Full chat completion (OpenAI-compatible). */
+  async chatCompletion(model, messages, options) {
+    const body = {
+      model,
+      messages,
+      max_tokens: options?.maxTokens || DEFAULT_MAX_TOKENS2
+    };
+    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 this.requestWithPayment("/v1/chat/completions", body);
+  }
+  /** List available models. */
+  async listModels() {
+    const response = await this.fetchWithTimeout(`${this.apiUrl}/v1/models`, { method: "GET" });
+    if (!response.ok) {
+      throw new APIError(`Failed to list models: ${response.status}`, response.status);
+    }
+    const data = await response.json();
+    return data.data || [];
+  }
+  /**
+   * Get Solana USDC balance.
+   *
+   * @returns USDC balance as a float
+   */
+  async getBalance() {
+    const usdc_mint = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+    const address = await this.getWalletAddress();
+    try {
+      const response = await fetch(this.rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "getTokenAccountsByOwner",
+          params: [address, { mint: usdc_mint }, { encoding: "jsonParsed" }]
+        })
+      });
+      const data = await response.json();
+      const accounts = data.result?.value || [];
+      if (!accounts.length) return 0;
+      let total = 0;
+      for (const acct of accounts) {
+        total += acct.account?.data?.parsed?.info?.tokenAmount?.uiAmount || 0;
+      }
+      return total;
+    } catch {
+      return 0;
+    }
+  }
+  /** Edit an image using img2img (Solana payment). */
+  async imageEdit(prompt, image, options) {
+    const body = {
+      model: options?.model || "openai/gpt-image-1",
+      prompt,
+      image,
+      size: options?.size || "1024x1024",
+      n: options?.n || 1
+    };
+    if (options?.mask !== void 0) body.mask = options.mask;
+    const data = await this.requestWithPaymentRaw("/v1/images/image2image", body);
+    return data;
+  }
+  /** Standalone search (Solana payment). */
+  async search(query, options) {
+    const body = { query, max_results: options?.maxResults || 10 };
+    if (options?.sources !== void 0) body.sources = options.sources;
+    if (options?.fromDate !== void 0) body.from_date = options.fromDate;
+    if (options?.toDate !== void 0) body.to_date = options.toDate;
+    const data = await this.requestWithPaymentRaw("/v1/search", body);
+    return data;
+  }
+  // ============================================================
+  // X/Twitter endpoints (powered by AttentionVC)
+  // ============================================================
+  async xUserLookup(usernames) {
+    const names = Array.isArray(usernames) ? usernames : [usernames];
+    const data = await this.requestWithPaymentRaw("/v1/x/users/lookup", { usernames: names });
+    return data;
+  }
+  async xFollowers(username, cursor) {
+    const body = { username };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/followers", body);
+    return data;
+  }
+  async xFollowings(username, cursor) {
+    const body = { username };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/followings", body);
+    return data;
+  }
+  async xUserInfo(username) {
+    const data = await this.requestWithPaymentRaw("/v1/x/users/info", { username });
+    return data;
+  }
+  async xVerifiedFollowers(userId, cursor) {
+    const body = { userId };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/verified-followers", body);
+    return data;
+  }
+  async xUserTweets(username, includeReplies = false, cursor) {
+    const body = { username, includeReplies };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/tweets", body);
+    return data;
+  }
+  async xUserMentions(username, sinceTime, untilTime, cursor) {
+    const body = { username };
+    if (sinceTime !== void 0) body.sinceTime = sinceTime;
+    if (untilTime !== void 0) body.untilTime = untilTime;
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/users/mentions", body);
+    return data;
+  }
+  async xTweetLookup(tweetIds) {
+    const ids = Array.isArray(tweetIds) ? tweetIds : [tweetIds];
+    const data = await this.requestWithPaymentRaw("/v1/x/tweets/lookup", { tweet_ids: ids });
+    return data;
+  }
+  async xTweetReplies(tweetId, queryType = "Latest", cursor) {
+    const body = { tweetId, queryType };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/tweets/replies", body);
+    return data;
+  }
+  async xTweetThread(tweetId, cursor) {
+    const body = { tweetId };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/tweets/thread", body);
+    return data;
+  }
+  async xSearch(query, queryType = "Latest", cursor) {
+    const body = { query, queryType };
+    if (cursor !== void 0) body.cursor = cursor;
+    const data = await this.requestWithPaymentRaw("/v1/x/search", body);
+    return data;
+  }
+  async xTrending() {
+    const data = await this.requestWithPaymentRaw("/v1/x/trending", {});
+    return data;
+  }
+  async xArticlesRising() {
+    const data = await this.requestWithPaymentRaw("/v1/x/articles/rising", {});
+    return data;
+  }
+  async xAuthorAnalytics(handle) {
+    const data = await this.requestWithPaymentRaw("/v1/x/authors", { handle });
+    return data;
+  }
+  async xCompareAuthors(handle1, handle2) {
+    const data = await this.requestWithPaymentRaw("/v1/x/compare", { handle1, handle2 });
+    return data;
   }
-  /** List available models. */
-  async listModels() {
-    const response = await this.fetchWithTimeout(`${this.apiUrl}/v1/models`, { method: "GET" });
-    if (!response.ok) {
-      throw new APIError(`Failed to list models: ${response.status}`, response.status);
-    }
-    const data = await response.json();
-    return data.data || [];
+  // ── Prediction Markets (Powered by Predexon) ────────────────────────────
+  async pm(path5, params) {
+    return this.getWithPaymentRaw(`/v1/pm/${path5}`, params);
+  }
+  async pmQuery(path5, query) {
+    return this.requestWithPaymentRaw(`/v1/pm/${path5}`, query);
   }
   /** Get session spending. */
   getSpending() {
@@ -37703,6 +38465,188 @@ var SolanaLLMClient = class {
     this.sessionTotalUsd += costUsd;
     return retryResponse.json();
   }
+  async requestWithPaymentRaw(endpoint2, body) {
+    const url2 = `${this.apiUrl}${endpoint2}`;
+    const response = await this.fetchWithTimeout(url2, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT2 },
+      body: JSON.stringify(body)
+    });
+    if (response.status === 402) {
+      return this.handlePaymentAndRetryRaw(url2, 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 handlePaymentAndRetryRaw(url2, body, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.accepts || respBody.x402Version) {
+          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, SOLANA_NETWORK);
+    if (!details.network?.startsWith("solana:")) {
+      throw new PaymentError(
+        `Expected Solana payment network, got: ${details.network}. Use LLMClient for Base payments.`
+      );
+    }
+    const feePayer = details.extra?.feePayer;
+    if (!feePayer) throw new PaymentError("Missing feePayer in 402 extra field");
+    const fromAddress = await this.getWalletAddress();
+    const secretKey = await solanaKeyToBytes(this.privateKey);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createSolanaPaymentPayload(
+      secretKey,
+      fromAddress,
+      details.recipient,
+      details.amount,
+      feePayer,
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url2,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun Solana AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions,
+        rpcUrl: this.rpcUrl
+      }
+    );
+    const retryResponse = await this.fetchWithTimeout(url2, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT2,
+        "PAYMENT-SIGNATURE": paymentPayload
+      },
+      body: JSON.stringify(body)
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your Solana USDC 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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
+  async getWithPaymentRaw(endpoint2, params) {
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const url2 = `${this.apiUrl}${endpoint2}${query}`;
+    const response = await this.fetchWithTimeout(url2, {
+      method: "GET",
+      headers: { "User-Agent": USER_AGENT2 }
+    });
+    if (response.status === 402) {
+      return this.handleGetPaymentAndRetryRaw(url2, endpoint2, params, 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 handleGetPaymentAndRetryRaw(url2, endpoint2, params, response) {
+    let paymentHeader = response.headers.get("payment-required");
+    if (!paymentHeader) {
+      try {
+        const respBody = await response.json();
+        if (respBody.accepts || respBody.x402Version) {
+          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, SOLANA_NETWORK);
+    if (!details.network?.startsWith("solana:")) {
+      throw new PaymentError(
+        `Expected Solana payment network, got: ${details.network}. Use LLMClient for Base payments.`
+      );
+    }
+    const feePayer = details.extra?.feePayer;
+    if (!feePayer) throw new PaymentError("Missing feePayer in 402 extra field");
+    const fromAddress = await this.getWalletAddress();
+    const secretKey = await solanaKeyToBytes(this.privateKey);
+    const extensions = paymentRequired.extensions;
+    const paymentPayload = await createSolanaPaymentPayload(
+      secretKey,
+      fromAddress,
+      details.recipient,
+      details.amount,
+      feePayer,
+      {
+        resourceUrl: validateResourceUrl(
+          details.resource?.url || url2,
+          this.apiUrl
+        ),
+        resourceDescription: details.resource?.description || "BlockRun Solana AI API call",
+        maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+        extra: details.extra,
+        extensions,
+        rpcUrl: this.rpcUrl
+      }
+    );
+    const query = params ? "?" + new URLSearchParams(params).toString() : "";
+    const retryUrl = `${this.apiUrl}${endpoint2}${query}`;
+    const retryResponse = await this.fetchWithTimeout(retryUrl, {
+      method: "GET",
+      headers: {
+        "User-Agent": USER_AGENT2,
+        "PAYMENT-SIGNATURE": paymentPayload
+      }
+    });
+    if (retryResponse.status === 402) {
+      throw new PaymentError("Payment was rejected. Check your Solana USDC 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 costUsd = parseFloat(details.amount) / 1e6;
+    this.sessionCalls += 1;
+    this.sessionTotalUsd += costUsd;
+    return retryResponse.json();
+  }
   async fetchWithTimeout(url2, options) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
@@ -37717,6 +38661,192 @@ function solanaClient(options = {}) {
   return new SolanaLLMClient({ ...options, apiUrl: SOLANA_API_URL });
 }
 
+// src/cache.ts
+var fs3 = __toESM(require("fs"), 1);
+var path3 = __toESM(require("path"), 1);
+var os3 = __toESM(require("os"), 1);
+var crypto6 = __toESM(require("crypto"), 1);
+var CACHE_DIR = path3.join(os3.homedir(), ".blockrun", "cache");
+var DEFAULT_TTL = {
+  "/v1/x/": 3600 * 1e3,
+  "/v1/partner/": 3600 * 1e3,
+  "/v1/pm/": 1800 * 1e3,
+  "/v1/chat/": 0,
+  "/v1/search": 900 * 1e3,
+  "/v1/image": 0,
+  "/v1/models": 86400 * 1e3
+};
+function getTtl(endpoint2) {
+  for (const [pattern, ttl] of Object.entries(DEFAULT_TTL)) {
+    if (endpoint2.includes(pattern)) return ttl;
+  }
+  return 3600 * 1e3;
+}
+function cacheKey(endpoint2, body) {
+  const keyData = JSON.stringify({ endpoint: endpoint2, body }, Object.keys({ endpoint: endpoint2, body }).sort());
+  return crypto6.createHash("sha256").update(keyData).digest("hex").slice(0, 16);
+}
+function cachePath(key) {
+  return path3.join(CACHE_DIR, `${key}.json`);
+}
+function getCached(key) {
+  const filePath = cachePath(key);
+  if (!fs3.existsSync(filePath)) return null;
+  try {
+    const raw = fs3.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);
+      } catch {
+      }
+      return null;
+    }
+    return entry.response;
+  } catch {
+    return null;
+  }
+}
+function getCachedByRequest(endpoint2, body) {
+  const ttl = getTtl(endpoint2);
+  if (ttl <= 0) return null;
+  const key = cacheKey(endpoint2, body);
+  return getCached(key);
+}
+function setCache(key, data, ttlMs) {
+  if (ttlMs <= 0) return;
+  try {
+    fs3.mkdirSync(CACHE_DIR, { recursive: true });
+  } catch {
+  }
+  const entry = {
+    cachedAt: Date.now(),
+    response: data,
+    ttlMs
+  };
+  try {
+    fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+  } catch {
+  }
+}
+function saveToCache(endpoint2, body, response, costUsd = 0) {
+  const ttl = getTtl(endpoint2);
+  if (ttl <= 0) return;
+  try {
+    fs3.mkdirSync(CACHE_DIR, { recursive: true });
+  } catch {
+  }
+  const key = cacheKey(endpoint2, body);
+  const entry = {
+    cachedAt: Date.now(),
+    endpoint: endpoint2,
+    body,
+    response,
+    costUsd
+  };
+  try {
+    fs3.writeFileSync(cachePath(key), JSON.stringify(entry));
+  } catch {
+  }
+}
+function clearCache() {
+  if (!fs3.existsSync(CACHE_DIR)) return 0;
+  let count = 0;
+  try {
+    const files = fs3.readdirSync(CACHE_DIR);
+    for (const file of files) {
+      if (file.endsWith(".json")) {
+        try {
+          fs3.unlinkSync(path3.join(CACHE_DIR, file));
+          count++;
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return count;
+}
+
+// src/setup.ts
+function setupAgentWallet(options) {
+  const { address, privateKey, isNew } = getOrCreateWallet();
+  if (isNew && !options?.silent) {
+    console.error(
+      `
+BlockRun Agent Wallet Created!
+Address: ${address}
+Send USDC on Base to get started.
+`
+    );
+  }
+  return new LLMClient({ privateKey });
+}
+async function setupAgentSolanaWallet(options) {
+  const result = await getOrCreateSolanaWallet();
+  if (result.isNew && !options?.silent) {
+    console.error(
+      `
+BlockRun Solana Agent Wallet Created!
+Address: ${result.address}
+Send USDC on Solana to get started.
+`
+    );
+  }
+  return new SolanaLLMClient({ privateKey: result.privateKey });
+}
+async function status() {
+  const client = setupAgentWallet({ silent: true });
+  const address = client.getWalletAddress();
+  const balance = await client.getBalance();
+  console.log(`Wallet: ${address}`);
+  console.log(`Balance: $${balance.toFixed(2)} USDC`);
+  return { address, balance };
+}
+
+// src/cost-log.ts
+var fs4 = __toESM(require("fs"), 1);
+var path4 = __toESM(require("path"), 1);
+var os4 = __toESM(require("os"), 1);
+var DATA_DIR = path4.join(os4.homedir(), ".blockrun", "data");
+var COST_LOG_FILE = path4.join(DATA_DIR, "costs.jsonl");
+function logCost(entry) {
+  try {
+    fs4.mkdirSync(DATA_DIR, { recursive: true });
+  } catch {
+  }
+  try {
+    fs4.appendFileSync(COST_LOG_FILE, JSON.stringify(entry) + "\n");
+  } catch {
+  }
+}
+function getCostSummary() {
+  if (!fs4.existsSync(COST_LOG_FILE)) {
+    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();
+    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;
@@ -37903,12 +39033,16 @@ var OpenAI = class {
   USDC_SOLANA,
   WALLET_DIR_PATH,
   WALLET_FILE_PATH,
+  clearCache,
   createSolanaPaymentPayload,
   createSolanaWallet,
   createWallet,
   formatFundingMessageCompact,
   formatNeedsFundingMessage,
   formatWalletCreatedMessage,
+  getCached,
+  getCachedByRequest,
+  getCostSummary,
   getEip681Uri,
   getOrCreateSolanaWallet,
   getOrCreateWallet,
@@ -37916,11 +39050,19 @@ var OpenAI = class {
   getWalletAddress,
   loadSolanaWallet,
   loadWallet,
+  logCost,
   saveSolanaWallet,
+  saveToCache,
   saveWallet,
+  scanSolanaWallets,
+  scanWallets,
+  setCache,
+  setupAgentSolanaWallet,
+  setupAgentWallet,
   solanaClient,
   solanaKeyToBytes,
   solanaPublicKey,
+  status,
   testnetClient
 });
 /*! Bundled license information: