@blockrun/llm 1.10.1 → 1.12.0

package/README.md

@@ -151,6 +151,13 @@ The classifier runs in <1ms, 100% locally, and routes to one of four tiers:
 
 ## Available Models
 
+### OpenAI GPT-5.5 Family
+Released 2026-04-23 — first fully retrained base since GPT-4.5. 1M context, 128K output, native agent + computer use.
+
+| Model | Input Price | Output Price |
+|-------|-------------|--------------|
+| `openai/gpt-5.5` | $5.00/M | $30.00/M |
+
 ### OpenAI GPT-5.4 Family
 | Model | Input Price | Output Price |
 |-------|-------------|--------------|

package/dist/index.cjs

@@ -1686,6 +1686,8 @@ var DEFAULT_API_URL2 = "https://blockrun.ai/api";
 var DEFAULT_MODEL = "google/nano-banana";
 var DEFAULT_SIZE = "1024x1024";
 var DEFAULT_TIMEOUT2 = 2e5;
+var POLL_INTERVAL_MS = 3e3;
+var POLL_MAX_DURATION_MS = 3e5;
 var ImageClient = class {
   account;
   privateKey;
@@ -1870,7 +1872,70 @@ var ImageClient = class {
         sanitizeErrorResponse(errorBody)
       );
     }
-    return retryResponse.json();
+    const responseBody = await retryResponse.json();
+    if (retryResponse.status === 202 || responseBody.status === "queued" || responseBody.status === "in_progress") {
+      if (!responseBody.poll_url) {
+        throw new APIError(
+          `Server returned ${retryResponse.status} but no poll_url to follow.`,
+          retryResponse.status,
+          sanitizeErrorResponse(responseBody)
+        );
+      }
+      return this.pollImageJob(responseBody.poll_url, paymentPayload);
+    }
+    return responseBody;
+  }
+  /**
+   * Poll the async image generation endpoint until the job reaches a terminal
+   * state (completed/failed). Used when the POST returns 202 + poll_url for
+   * slow models that exceeded the server's inline window.
+   *
+   * Sends the SAME payment header on every poll — the server binds the payer
+   * to the job id and re-verifies on each call. Settlement happens server-side
+   * on the first poll where status=completed.
+   */
+  async pollImageJob(pollPath, paymentHeader) {
+    const pollUrl = pollPath.startsWith("/api/") ? `${this.apiUrl.replace(/\/api$/, "")}${pollPath}` : `${this.apiUrl}${pollPath.startsWith("/") ? "" : "/"}${pollPath}`;
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < POLL_MAX_DURATION_MS) {
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+      const pollResp = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: {
+          "PAYMENT-SIGNATURE": paymentHeader,
+          "X-PAYMENT": paymentHeader
+        }
+      });
+      if (pollResp.status === 202) {
+        continue;
+      }
+      const pollBody = await pollResp.json().catch(() => ({}));
+      if (!pollResp.ok) {
+        throw new APIError(
+          `API error during poll: ${pollResp.status}`,
+          pollResp.status,
+          sanitizeErrorResponse(pollBody)
+        );
+      }
+      if (pollBody.status === "failed") {
+        throw new APIError(
+          pollBody.error || "Upstream image generation failed",
+          200,
+          sanitizeErrorResponse(pollBody)
+        );
+      }
+      if (pollBody.data) {
+        return pollBody;
+      }
+      if (pollBody.status === "queued" || pollBody.status === "in_progress") {
+        continue;
+      }
+    }
+    throw new APIError(
+      `Image generation poll timed out after ${POLL_MAX_DURATION_MS / 1e3}s`,
+      504,
+      { error: "poll_timeout", poll_url: pollPath }
+    );
   }
   /**
    * Fetch with timeout.

package/dist/index.d.cts

@@ -1195,6 +1195,16 @@ declare class ImageClient {
      * Handle 402 response: parse requirements, sign payment, retry.
      */
     private handlePaymentAndRetry;
+    /**
+     * Poll the async image generation endpoint until the job reaches a terminal
+     * state (completed/failed). Used when the POST returns 202 + poll_url for
+     * slow models that exceeded the server's inline window.
+     *
+     * Sends the SAME payment header on every poll — the server binds the payer
+     * to the job id and re-verifies on each call. Settlement happens server-side
+     * on the first poll where status=completed.
+     */
+    private pollImageJob;
     /**
      * Fetch with timeout.
      */

package/dist/index.d.ts

@@ -1195,6 +1195,16 @@ declare class ImageClient {
      * Handle 402 response: parse requirements, sign payment, retry.
      */
     private handlePaymentAndRetry;
+    /**
+     * Poll the async image generation endpoint until the job reaches a terminal
+     * state (completed/failed). Used when the POST returns 202 + poll_url for
+     * slow models that exceeded the server's inline window.
+     *
+     * Sends the SAME payment header on every poll — the server binds the payer
+     * to the job id and re-verifies on each call. Settlement happens server-side
+     * on the first poll where status=completed.
+     */
+    private pollImageJob;
     /**
      * Fetch with timeout.
      */

package/dist/index.js

@@ -1597,6 +1597,8 @@ var DEFAULT_API_URL2 = "https://blockrun.ai/api";
 var DEFAULT_MODEL = "google/nano-banana";
 var DEFAULT_SIZE = "1024x1024";
 var DEFAULT_TIMEOUT2 = 2e5;
+var POLL_INTERVAL_MS = 3e3;
+var POLL_MAX_DURATION_MS = 3e5;
 var ImageClient = class {
   account;
   privateKey;
@@ -1781,7 +1783,70 @@ var ImageClient = class {
         sanitizeErrorResponse(errorBody)
       );
     }
-    return retryResponse.json();
+    const responseBody = await retryResponse.json();
+    if (retryResponse.status === 202 || responseBody.status === "queued" || responseBody.status === "in_progress") {
+      if (!responseBody.poll_url) {
+        throw new APIError(
+          `Server returned ${retryResponse.status} but no poll_url to follow.`,
+          retryResponse.status,
+          sanitizeErrorResponse(responseBody)
+        );
+      }
+      return this.pollImageJob(responseBody.poll_url, paymentPayload);
+    }
+    return responseBody;
+  }
+  /**
+   * Poll the async image generation endpoint until the job reaches a terminal
+   * state (completed/failed). Used when the POST returns 202 + poll_url for
+   * slow models that exceeded the server's inline window.
+   *
+   * Sends the SAME payment header on every poll — the server binds the payer
+   * to the job id and re-verifies on each call. Settlement happens server-side
+   * on the first poll where status=completed.
+   */
+  async pollImageJob(pollPath, paymentHeader) {
+    const pollUrl = pollPath.startsWith("/api/") ? `${this.apiUrl.replace(/\/api$/, "")}${pollPath}` : `${this.apiUrl}${pollPath.startsWith("/") ? "" : "/"}${pollPath}`;
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < POLL_MAX_DURATION_MS) {
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+      const pollResp = await this.fetchWithTimeout(pollUrl, {
+        method: "GET",
+        headers: {
+          "PAYMENT-SIGNATURE": paymentHeader,
+          "X-PAYMENT": paymentHeader
+        }
+      });
+      if (pollResp.status === 202) {
+        continue;
+      }
+      const pollBody = await pollResp.json().catch(() => ({}));
+      if (!pollResp.ok) {
+        throw new APIError(
+          `API error during poll: ${pollResp.status}`,
+          pollResp.status,
+          sanitizeErrorResponse(pollBody)
+        );
+      }
+      if (pollBody.status === "failed") {
+        throw new APIError(
+          pollBody.error || "Upstream image generation failed",
+          200,
+          sanitizeErrorResponse(pollBody)
+        );
+      }
+      if (pollBody.data) {
+        return pollBody;
+      }
+      if (pollBody.status === "queued" || pollBody.status === "in_progress") {
+        continue;
+      }
+    }
+    throw new APIError(
+      `Image generation poll timed out after ${POLL_MAX_DURATION_MS / 1e3}s`,
+      504,
+      { error: "poll_timeout", poll_url: pollPath }
+    );
   }
   /**
    * Fetch with timeout.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "1.10.1",
+  "version": "1.12.0",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music) via x402 on Base and Solana",
   "main": "dist/index.cjs",