@blockrun/franklin 3.15.44 → 3.15.45

package/dist/tools/imagegen.js

@@ -258,7 +258,29 @@ function buildExecute(deps) {
             const result = await response.json();
             const imageData = result.data?.[0];
             if (!imageData) {
-                return { output: 'No image data returned from API', isError: true };
+                // Some gateways return 200 with an `error` / `message` field for
+                // moderation, quota, or upstream-model failures instead of using
+                // HTTP error codes. Without surfacing those, the agent sees only
+                // "No image data returned from API" and starts guessing — verified
+                // 2026-05-04: agent guessed "gpt-image-2 is forced to 1024x1024
+                // per the tool docs" and burned a retry on a size param that
+                // wasn't the actual cause. Surface the diagnostic so the agent
+                // (or user) can react.
+                const bits = [];
+                if (result.error !== undefined) {
+                    bits.push(`error=${JSON.stringify(result.error).slice(0, 240)}`);
+                }
+                if (result.message !== undefined) {
+                    bits.push(`message=${String(result.message).slice(0, 240)}`);
+                }
+                if (Array.isArray(result.data) && result.data.length === 0) {
+                    bits.push('data=[] (empty array — likely content moderation)');
+                }
+                else if (result.data === undefined) {
+                    bits.push('data field missing');
+                }
+                const detail = bits.length > 0 ? ` — ${bits.join('; ')}` : '';
+                return { output: `No image data returned from API${detail}`, isError: true };
             }
             // Save image. The /v1/images/image2image endpoint returns Gemini results
             // as a data URI in `url`, so decode those locally instead of going through

package/dist/tools/videogen.js

@@ -192,7 +192,18 @@ function buildExecute(deps) {
             ctx.abortSignal.removeEventListener('abort', submitAbort);
         }
         if (!submitResult.poll_url || !paymentHeaders) {
-            return { output: 'API did not return a poll_url for the video job', isError: true };
+            // Surface any diagnostic the body contained — same rationale as
+            // imagegen.ts: "missing field" tells the agent nothing about
+            // whether it was moderation, quota, or upstream model failure.
+            const bits = [];
+            if (!paymentHeaders)
+                bits.push('payment headers missing');
+            if (submitResult?.error !== undefined)
+                bits.push(`error=${JSON.stringify(submitResult.error).slice(0, 240)}`);
+            if (submitResult?.message !== undefined)
+                bits.push(`message=${String(submitResult.message).slice(0, 240)}`);
+            const detail = bits.length > 0 ? ` — ${bits.join('; ')}` : '';
+            return { output: `API did not return a poll_url for the video job${detail}`, isError: true };
         }
         // Phase 2: poll GET /v1/videos/generations/{id} with the SAME signed
         // x-payment header until the job completes. Server settles on the first
@@ -218,7 +229,17 @@ function buildExecute(deps) {
         const videoData = outcome.data;
         const videoUrl = videoData.url;
         if (!videoUrl) {
-            return { output: 'No video URL returned from API', isError: true };
+            // Same diagnostic pattern as the submit-side path above.
+            const d = videoData;
+            const bits = [];
+            if (d.error !== undefined)
+                bits.push(`error=${JSON.stringify(d.error).slice(0, 240)}`);
+            if (d.message !== undefined)
+                bits.push(`message=${String(d.message).slice(0, 240)}`);
+            if (d.status !== undefined)
+                bits.push(`status=${String(d.status).slice(0, 80)}`);
+            const detail = bits.length > 0 ? ` — ${bits.join('; ')}` : '';
+            return { output: `No video URL returned from API${detail}`, isError: true };
         }
         try {
             // Download the MP4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.15.44",
+  "version": "3.15.45",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {