@blockrun/llm 3.2.2 → 3.3.0

package/dist/index.cjs

@@ -2522,8 +2522,9 @@ var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_MODEL4 = "xai/grok-imagine-video";
 var DEFAULT_TIMEOUT5 = 12e4;
 var POLL_INTERVAL_MS2 = 5e3;
-var DEFAULT_GENERATE_BUDGET_MS = 3e5;
+var DEFAULT_GENERATE_BUDGET_MS = 9e5;
 var MAX_TIMEOUT_SECONDS = 600;
+var MAX_POLL_RESIGNS = 2;
 var VideoClient = class {
   account;
   privateKey;
@@ -2551,8 +2552,9 @@ var VideoClient = class {
    * Generate a short video clip from a text prompt (or text + image).
    *
    * Submits an async job, then polls until the video is ready. Typical total
-   * wall-time is 60-180s. If upstream runs past the budget (default 5min),
-   * throws without charging.
+   * wall-time is 60-180s, but upstream status can lag several minutes behind
+   * actual completion. If upstream runs past the budget (default 15min),
+   * throws without charging — the job stays claimable ~48h via poll_url.
    *
    * @param prompt - Text description of the video
    * @param options - Optional generation parameters
@@ -2670,21 +2672,9 @@ var VideoClient = class {
     if (resp402.status !== 402) {
       await this.throwApiError(resp402, "Expected 402 on first POST");
     }
-    const paymentRequired = await this.extractPaymentRequired(resp402);
-    const details = extractPaymentDetails(paymentRequired);
-    const paymentPayload = await createPaymentPayload(
-      this.privateKey,
-      this.account.address,
-      details.recipient,
-      details.amount,
-      details.network || "eip155:8453",
-      {
-        resourceUrl: details.resource?.url || submitUrl,
-        resourceDescription: details.resource?.description || "BlockRun Video Generation",
-        // Ensure signed auth covers the entire polling window.
-        maxTimeoutSeconds: Math.max(details.maxTimeoutSeconds || 0, MAX_TIMEOUT_SECONDS),
-        extra: details.extra
-      }
+    let { payload: paymentPayload, details } = await this.signFromChallenge(
+      resp402,
+      submitUrl
     );
     const submitResp = await this.fetchWithTimeout(submitUrl, {
       method: "POST",
@@ -2711,6 +2701,7 @@ var VideoClient = class {
     const pollUrl = this.absolute(submitData.poll_url);
     const deadline = Date.now() + budgetMs;
     let lastStatus = submitData.status || "queued";
+    let resignsLeft = MAX_POLL_RESIGNS;
     while (Date.now() < deadline) {
       await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS2));
       const pollResp = await this.fetchWithTimeout(pollUrl, {
@@ -2733,24 +2724,63 @@ var VideoClient = class {
           sanitizeErrorResponse(pollData)
         );
       }
-      if (pollResp.status === 200 && lastStatus === "completed") {
+      if (lastStatus === "completed") {
         const data = pollData;
-        const billedSeconds = typeof body.duration_seconds === "number" ? body.duration_seconds : 8;
         this.sessionCalls++;
-        this.sessionTotalUsd += 0.05 * billedSeconds * 1.05;
+        this.sessionTotalUsd += Number(details.amount) / 1e6;
         const txHash = pollResp.headers.get("x-payment-receipt") || pollResp.headers.get("X-Payment-Receipt");
         if (txHash) data.txHash = txHash;
         return data;
       }
+      if (pollResp.status === 402) {
+        if (resignsLeft > 0) {
+          resignsLeft--;
+          const challenge = await this.fetchWithTimeout(pollUrl, { method: "GET" });
+          if (challenge.status === 402) {
+            ({ payload: paymentPayload, details } = await this.signFromChallenge(
+              challenge,
+              pollUrl
+            ));
+            continue;
+          }
+        }
+        throw new PaymentError(
+          "Payment verification failed mid-poll (not a signature-expiry). Check the wallet balance and that you poll from the wallet that submitted the job."
+        );
+      }
       if (pollResp.status !== 200 && pollResp.status !== 202 && pollResp.status !== 504) {
         await this.throwApiError(pollResp, "Poll failed");
       }
     }
     throw new APIError(
-      `Video generation did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken.`,
+      `Video generation did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken. The job is NOT lost: it stays claimable for ~48h \u2014 re-GET poll_url with a fresh signature from the same wallet to fetch (and settle) the finished video.`,
       504,
-      { id: submitData.id, last_status: lastStatus }
+      { id: submitData.id, last_status: lastStatus, poll_url: pollUrl }
+    );
+  }
+  /**
+   * Parse an x402 challenge response and sign a payment payload for it.
+   * Used for the initial submit AND for mid-poll re-signing after the 600s
+   * authorization window lapses on long polls.
+   */
+  async signFromChallenge(resp402, fallbackUrl) {
+    const paymentRequired = await this.extractPaymentRequired(resp402);
+    const details = extractPaymentDetails(paymentRequired);
+    const payload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || fallbackUrl,
+        resourceDescription: details.resource?.description || "BlockRun Video Generation",
+        // Ensure signed auth covers as much of the polling window as allowed.
+        maxTimeoutSeconds: Math.max(details.maxTimeoutSeconds || 0, MAX_TIMEOUT_SECONDS),
+        extra: details.extra
+      }
     );
+    return { payload, details };
   }
   absolute(url) {
     if (url.startsWith("http://") || url.startsWith("https://")) return url;

package/dist/index.d.cts

@@ -1658,7 +1658,8 @@ declare class SpeechClient {
  *   POST /v1/videos/generations         -> 402 -> sign -> 202 { id, poll_url }
  *   GET  /v1/videos/generations/{id}    -> loop until status=completed
  *
- * The client signs ONCE and replays the same PAYMENT-SIGNATURE on every poll.
+ * The client signs once and replays the same PAYMENT-SIGNATURE on every poll,
+ * re-signing automatically if the 600s authorization window lapses mid-poll.
  * Settlement happens only on the first completed poll, so upstream failure or
  * the caller giving up = zero charge.
  *
@@ -1689,8 +1690,9 @@ declare class VideoClient {
      * Generate a short video clip from a text prompt (or text + image).
      *
      * Submits an async job, then polls until the video is ready. Typical total
-     * wall-time is 60-180s. If upstream runs past the budget (default 5min),
-     * throws without charging.
+     * wall-time is 60-180s, but upstream status can lag several minutes behind
+     * actual completion. If upstream runs past the budget (default 15min),
+     * throws without charging — the job stays claimable ~48h via poll_url.
      *
      * @param prompt - Text description of the video
      * @param options - Optional generation parameters
@@ -1734,6 +1736,12 @@ declare class VideoClient {
         returnLastFrame?: boolean;
     } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
+    /**
+     * Parse an x402 challenge response and sign a payment payload for it.
+     * Used for the initial submit AND for mid-poll re-signing after the 600s
+     * authorization window lapses on long polls.
+     */
+    private signFromChallenge;
     private absolute;
     private extractPaymentRequired;
     private throwApiError;

package/dist/index.d.ts

@@ -1658,7 +1658,8 @@ declare class SpeechClient {
  *   POST /v1/videos/generations         -> 402 -> sign -> 202 { id, poll_url }
  *   GET  /v1/videos/generations/{id}    -> loop until status=completed
  *
- * The client signs ONCE and replays the same PAYMENT-SIGNATURE on every poll.
+ * The client signs once and replays the same PAYMENT-SIGNATURE on every poll,
+ * re-signing automatically if the 600s authorization window lapses mid-poll.
  * Settlement happens only on the first completed poll, so upstream failure or
  * the caller giving up = zero charge.
  *
@@ -1689,8 +1690,9 @@ declare class VideoClient {
      * Generate a short video clip from a text prompt (or text + image).
      *
      * Submits an async job, then polls until the video is ready. Typical total
-     * wall-time is 60-180s. If upstream runs past the budget (default 5min),
-     * throws without charging.
+     * wall-time is 60-180s, but upstream status can lag several minutes behind
+     * actual completion. If upstream runs past the budget (default 15min),
+     * throws without charging — the job stays claimable ~48h via poll_url.
      *
      * @param prompt - Text description of the video
      * @param options - Optional generation parameters
@@ -1734,6 +1736,12 @@ declare class VideoClient {
         returnLastFrame?: boolean;
     } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
+    /**
+     * Parse an x402 challenge response and sign a payment payload for it.
+     * Used for the initial submit AND for mid-poll re-signing after the 600s
+     * authorization window lapses on long polls.
+     */
+    private signFromChallenge;
     private absolute;
     private extractPaymentRequired;
     private throwApiError;

package/dist/index.js

@@ -2415,8 +2415,9 @@ var DEFAULT_API_URL5 = "https://blockrun.ai/api";
 var DEFAULT_MODEL4 = "xai/grok-imagine-video";
 var DEFAULT_TIMEOUT5 = 12e4;
 var POLL_INTERVAL_MS2 = 5e3;
-var DEFAULT_GENERATE_BUDGET_MS = 3e5;
+var DEFAULT_GENERATE_BUDGET_MS = 9e5;
 var MAX_TIMEOUT_SECONDS = 600;
+var MAX_POLL_RESIGNS = 2;
 var VideoClient = class {
   account;
   privateKey;
@@ -2444,8 +2445,9 @@ var VideoClient = class {
    * Generate a short video clip from a text prompt (or text + image).
    *
    * Submits an async job, then polls until the video is ready. Typical total
-   * wall-time is 60-180s. If upstream runs past the budget (default 5min),
-   * throws without charging.
+   * wall-time is 60-180s, but upstream status can lag several minutes behind
+   * actual completion. If upstream runs past the budget (default 15min),
+   * throws without charging — the job stays claimable ~48h via poll_url.
    *
    * @param prompt - Text description of the video
    * @param options - Optional generation parameters
@@ -2563,21 +2565,9 @@ var VideoClient = class {
     if (resp402.status !== 402) {
       await this.throwApiError(resp402, "Expected 402 on first POST");
     }
-    const paymentRequired = await this.extractPaymentRequired(resp402);
-    const details = extractPaymentDetails(paymentRequired);
-    const paymentPayload = await createPaymentPayload(
-      this.privateKey,
-      this.account.address,
-      details.recipient,
-      details.amount,
-      details.network || "eip155:8453",
-      {
-        resourceUrl: details.resource?.url || submitUrl,
-        resourceDescription: details.resource?.description || "BlockRun Video Generation",
-        // Ensure signed auth covers the entire polling window.
-        maxTimeoutSeconds: Math.max(details.maxTimeoutSeconds || 0, MAX_TIMEOUT_SECONDS),
-        extra: details.extra
-      }
+    let { payload: paymentPayload, details } = await this.signFromChallenge(
+      resp402,
+      submitUrl
     );
     const submitResp = await this.fetchWithTimeout(submitUrl, {
       method: "POST",
@@ -2604,6 +2594,7 @@ var VideoClient = class {
     const pollUrl = this.absolute(submitData.poll_url);
     const deadline = Date.now() + budgetMs;
     let lastStatus = submitData.status || "queued";
+    let resignsLeft = MAX_POLL_RESIGNS;
     while (Date.now() < deadline) {
       await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS2));
       const pollResp = await this.fetchWithTimeout(pollUrl, {
@@ -2626,24 +2617,63 @@ var VideoClient = class {
           sanitizeErrorResponse(pollData)
         );
       }
-      if (pollResp.status === 200 && lastStatus === "completed") {
+      if (lastStatus === "completed") {
         const data = pollData;
-        const billedSeconds = typeof body.duration_seconds === "number" ? body.duration_seconds : 8;
         this.sessionCalls++;
-        this.sessionTotalUsd += 0.05 * billedSeconds * 1.05;
+        this.sessionTotalUsd += Number(details.amount) / 1e6;
         const txHash = pollResp.headers.get("x-payment-receipt") || pollResp.headers.get("X-Payment-Receipt");
         if (txHash) data.txHash = txHash;
         return data;
       }
+      if (pollResp.status === 402) {
+        if (resignsLeft > 0) {
+          resignsLeft--;
+          const challenge = await this.fetchWithTimeout(pollUrl, { method: "GET" });
+          if (challenge.status === 402) {
+            ({ payload: paymentPayload, details } = await this.signFromChallenge(
+              challenge,
+              pollUrl
+            ));
+            continue;
+          }
+        }
+        throw new PaymentError(
+          "Payment verification failed mid-poll (not a signature-expiry). Check the wallet balance and that you poll from the wallet that submitted the job."
+        );
+      }
       if (pollResp.status !== 200 && pollResp.status !== 202 && pollResp.status !== 504) {
         await this.throwApiError(pollResp, "Poll failed");
       }
     }
     throw new APIError(
-      `Video generation did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken.`,
+      `Video generation did not complete within ${Math.round(budgetMs / 1e3)}s (last status: ${lastStatus}). No payment was taken. The job is NOT lost: it stays claimable for ~48h \u2014 re-GET poll_url with a fresh signature from the same wallet to fetch (and settle) the finished video.`,
       504,
-      { id: submitData.id, last_status: lastStatus }
+      { id: submitData.id, last_status: lastStatus, poll_url: pollUrl }
+    );
+  }
+  /**
+   * Parse an x402 challenge response and sign a payment payload for it.
+   * Used for the initial submit AND for mid-poll re-signing after the 600s
+   * authorization window lapses on long polls.
+   */
+  async signFromChallenge(resp402, fallbackUrl) {
+    const paymentRequired = await this.extractPaymentRequired(resp402);
+    const details = extractPaymentDetails(paymentRequired);
+    const payload = await createPaymentPayload(
+      this.privateKey,
+      this.account.address,
+      details.recipient,
+      details.amount,
+      details.network || "eip155:8453",
+      {
+        resourceUrl: details.resource?.url || fallbackUrl,
+        resourceDescription: details.resource?.description || "BlockRun Video Generation",
+        // Ensure signed auth covers as much of the polling window as allowed.
+        maxTimeoutSeconds: Math.max(details.maxTimeoutSeconds || 0, MAX_TIMEOUT_SECONDS),
+        extra: details.extra
+      }
     );
+    return { payload, details };
   }
   absolute(url) {
     if (url.startsWith("http://") || url.startsWith("https://")) return url;

package/package.json

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