@koda-sl/baker-cli 0.124.0-dev.31b784126 → 0.124.0-dev.efe965ce2

package/README.md

@@ -2132,6 +2132,8 @@ Auto-ingests with prefetched bytes (no double-fetch). The screenshot bytes thems
 
 ScreenshotOne caches captures for 30 days, so re-shotting the same URL within that window returns the cached capture.
 
+If the target page is unreachable or returns a non-2xx status (e.g. a 404 path or a login wall), the command fails with an actionable `VALIDATION_ERROR` naming the page and the status it returned, plus a `fix` hint — verify the URL and retry, or continue without the screenshot. It no longer surfaces a generic "Internal server error".
+
 **Flags:**
 
 | Flag           | Description                                                                                |

package/dist/cli.js

@@ -23517,7 +23517,20 @@ var screenshotCommand = defineCommand121({
       writeJson({ ok: true, data });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        const isUrlProblem = err.code === "VALIDATION_ERROR" || err.code === "NOT_FOUND";
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            ...isUrlProblem ? {
+              fix: {
+                action: "reject",
+                explanation: "Verify the URL is correct and publicly reachable, then retry with a working address. If the page can't be captured, continue without this screenshot rather than stopping the job."
+              }
+            } : {}
+          }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });