dreamlayer 0.4.0-beta.2 → 0.4.0-beta.3

package/README.md

@@ -167,3 +167,7 @@ retry the indicated recovery action, never blindly repeat a paid command.
 use `authentication_failed` (exit 2). A cancelled run uses `execution_cancelled`, exit 4,
 and a JSON error on stderr. Unknown client failures use `client_error`; they do not
 prove that the server-side generation failed.
+
+## Error handling updates in beta.3
+
+Transport failures include a safe connection category without exposing URLs or credentials. Cancelled executions recommend a status check; download authentication failures retain exit code 2. Help flags are parsed as options so a literal `-h` option value is preserved.

package/dist/cli.js

@@ -102,7 +102,9 @@ async function downloadOutput(api, url) {
     try {
         return await api.download(url);
     }
-    catch {
+    catch (error) {
+        if (error instanceof ApiError && [401, 403].includes(error.status))
+            throw error;
         throw new CommandError("download_failed", "The completed output could not be downloaded.", 5, true, "Retry dreamlayer download with the saved execution_id. Do not generate again.");
     }
 }
@@ -116,11 +118,14 @@ function parseOptions(argv) {
         aspect: "1:1",
         json: false,
         quiet: false,
+        help: false,
         idempotencyKey: null,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const token = argv[i];
-        if (token === "--json")
+        if (token === "--help" || token === "-h")
+            options.help = true;
+        else if (token === "--json")
             options.json = true;
         else if (token === "--quiet")
             options.quiet = true;
@@ -317,15 +322,15 @@ async function main(argv) {
         process.stdout.write(USAGE);
         return command ? 0 : 1;
     }
-    if (rest.includes("--help") || rest.includes("-h")) {
-        process.stdout.write(USAGE);
-        return 0;
-    }
     if (command === "--version" || command === "-v") {
         process.stdout.write(`${PACKAGE_VERSION}\n`);
         return 0;
     }
     const { positional, options } = parseOptions(rest);
+    if (options.help) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
     if (["generate", "edit", "cutout", "upscale", "sprite", "answer"].includes(command)) {
         options.out ??= command === "sprite" ? `dreamlayer-${Date.now()}.zip` : defaultOut();
         await preflightOutput(options.out);
@@ -441,7 +446,7 @@ main(process.argv.slice(2))
     const known = error instanceof CommandError ? error : error instanceof InputValidationError
         ? new CommandError("invalid_request", error.message, 1)
         : error instanceof RecoveryRequiredError
-            ? new CommandError("temporarily_unavailable", "Execution state is uncertain. Read saved state before retrying.", 5, true, "Use status and download for the saved execution. If no ID was received, replay identical inputs with the original idempotency key.") : null;
+            ? new CommandError("temporarily_unavailable", error.message, 5, true, "Use status and download for the saved execution. If no ID was received, replay identical inputs with the original idempotency key.") : null;
     if (known) {
         const partial = error.partialOutcome;
         const identity = { ...recovery, ...(partial?.execution_id ? { execution_id: partial.execution_id } : {}) };
@@ -449,9 +454,12 @@ main(process.argv.slice(2))
         if (process.argv.slice(2).includes("--json"))
             process.stderr.write(`${JSON.stringify(envelope)}\n`);
         else {
-            process.stderr.write(`${known.message}\n${known.guidance ?? ""}\n`);
-            if (identity.execution_id)
-                process.stderr.write(`Execution: ${identity.execution_id}\n  dreamlayer status ${identity.execution_id}\n  dreamlayer download ${identity.execution_id} --out <new-file>\n`);
+            process.stderr.write(`${known.message}\n${known.guidance ? known.guidance + "\n" : ""}`);
+            if (identity.execution_id) {
+                process.stderr.write(`Execution: ${identity.execution_id}\n  dreamlayer status ${identity.execution_id}\n`);
+                if (["local_output_failed", "download_failed"].includes(known.reason))
+                    process.stderr.write(`  dreamlayer download ${identity.execution_id} --out <new-file>\n`);
+            }
             if (identity.idempotency_key)
                 process.stderr.write(`Idempotency key: ${identity.idempotency_key}\n`);
         }
@@ -482,12 +490,7 @@ main(process.argv.slice(2))
             : error.retryable
                 ? "Temporary. Retry with --idempotency-key to avoid paying twice."
                 : "";
-        if (process.argv.slice(2).includes("--json")) {
-            process.stderr.write(`${JSON.stringify(error.toPublicEnvelope())}\n`);
-        }
-        else {
-            process.stderr.write(`${error.message}\nReason: ${error.reason}${hint ? `\n${hint}` : ""}\n`);
-        }
+        process.stderr.write(`${error.message}\nReason: ${error.reason}${hint ? `\n${hint}` : ""}\n`);
         process.exitCode = exitCodeFor(error);
         return;
     }

package/dist/client.js

@@ -491,8 +491,16 @@ export class ManagedClient {
                     throw error;
                 if (!executionId && error instanceof ApiError)
                     throw error;
-                if (!executionId || ++failures > 5)
-                    throw new RecoveryRequiredError("Execution state is uncertain. Read saved state before retrying.");
+                if (!executionId || ++failures > 5) {
+                    const code = error?.cause?.code ?? error?.code;
+                    const causes = {
+                        ECONNREFUSED: "Connection refused", ENOTFOUND: "Host lookup failed", EAI_AGAIN: "Host lookup temporarily failed",
+                        ECONNRESET: "Connection reset", ETIMEDOUT: "Connection timed out", UND_ERR_CONNECT_TIMEOUT: "Connection timed out",
+                        UND_ERR_SOCKET: "Connection closed", CERT_HAS_EXPIRED: "TLS certificate expired", DEPTH_ZERO_SELF_SIGNED_CERT: "TLS certificate is untrusted",
+                    };
+                    const cause = code && causes[code] ? `${causes[code]} (${code}). ` : "Transport connection failed. ";
+                    throw new RecoveryRequiredError(cause + "Execution state is uncertain. Read saved state before retrying.");
+                }
             }
             if (!executionId)
                 throw new RecoveryRequiredError("Execution stream ended before an identifier was received; reuse your idempotency key.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dreamlayer",
-  "version": "0.4.0-beta.2",
+  "version": "0.4.0-beta.3",
   "description": "Generate and edit images from your terminal, over local files, with one API key.",
   "license": "MIT",
   "type": "module",