image-skill 0.1.67 → 0.1.68

package/CHANGELOG.md

@@ -6,6 +6,15 @@ provenance; this file is the human- and agent-readable release map.
 
 ## Unreleased
 
+## 0.1.68 - 2026-06-18
+
+- Release (activation/self-fund): publish the quote-auth retry handoff from
+  #2002 so a valid unauthenticated `credits quote` failure preserves the exact
+  `error.recovery.after_auth` retry command, plus env-token and stdin-token
+  handoffs, after signup. The quote remains no-charge: no buy, wallet
+  settlement, provider call, credit debit, media write, hosted deploy, or
+  production write changed in this release bump.
+
 ## 0.1.67 - 2026-06-18
 
 - Activation/self-fund: when `create --guide` reaches `ready_to_create` and

package/bin/image-skill.mjs

@@ -15,7 +15,7 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import os from "node:os";
 
-const VERSION = "0.1.67";
+const VERSION = "0.1.68";
 const PACKAGE_NAME = "image-skill";
 const DEFAULT_API_BASE_URL = "https://api.image-skill.com";
 const DEFAULT_DOCS_BASE_URL = "https://image-skill.com";
@@ -1192,10 +1192,6 @@ async function credits(argv) {
     if (credentialFlag !== null) {
       return credentialFlag;
     }
-    const token = await resolveToken(args);
-    if (!token.ok) {
-      return token.result;
-    }
     const creditsValue = flagNumber(args, "credits");
     const pack = flagString(args, "pack");
     if (creditsValue === null && pack === null) {
@@ -1222,6 +1218,16 @@ async function credits(argv) {
         `public credits quote supports --payment-method ${PUBLIC_QUOTE_PAYMENT_METHODS.join(" or ")}`,
       );
     }
+    const token = await resolveToken(args);
+    if (!token.ok) {
+      return withCreditQuoteAuthRecovery(token.result, {
+        args,
+        creditsValue,
+        pack,
+        paymentMethod,
+        idempotency,
+      });
+    }
     const body = {
       ...(creditsValue === null ? {} : { credits: creditsValue }),
       ...(pack === null ? {} : { pack_id: pack }),
@@ -3059,6 +3065,63 @@ function renderCopyRunnablePaymentCommand(commandPrefix, command) {
   return renderGuidePrefixedCommand(commandPrefix, command);
 }
 
+function withCreditQuoteAuthRecovery(result, input) {
+  const command = renderCopyRunnablePaymentCommand(
+    createGuideCommandPrefix(),
+    renderCreditQuoteRetryCommand(input),
+  );
+  return {
+    ...result,
+    envelope: {
+      ...result.envelope,
+      error: {
+        ...result.envelope.error,
+        recovery: {
+          ...(result.envelope.error?.recovery ?? {}),
+          after_auth: {
+            command,
+            command_copy_runnable: true,
+            with_env: `IMAGE_SKILL_TOKEN="$IMAGE_SKILL_TOKEN" ${command}`,
+            with_stdin: renderTokenStdinCommand(command),
+            accepted_methods: ["config", "IMAGE_SKILL_TOKEN", "--token-stdin"],
+            requires_auth: true,
+            command_effect: {
+              label: "live_money_quote_no_charge",
+              live_money: true,
+              payment_object: true,
+              payment_attempt: false,
+              wallet_settlement: false,
+              provider_call: false,
+              credit_debit: false,
+              media_write: false,
+            },
+          },
+        },
+      },
+    },
+  };
+}
+
+function renderCreditQuoteRetryCommand(input) {
+  return [
+    "image-skill credits quote",
+    ...(input.pack === null
+      ? ["--credits", String(input.creditsValue)]
+      : ["--pack", input.pack]),
+    "--payment-method",
+    input.paymentMethod,
+    "--idempotency-key",
+    input.idempotency.value,
+    ...quoteRetryApiBaseArgs(input.args),
+    "--json",
+  ].join(" ");
+}
+
+function quoteRetryApiBaseArgs(args) {
+  const apiBaseUrl = explicitApiBaseUrl(args);
+  return apiBaseUrl === null ? [] : ["--api-base-url", shellQuote(apiBaseUrl)];
+}
+
 function createGuideStage(input) {
   if (input.promptRequired) {
     return "prompt_required";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "image-skill",
-  "version": "0.1.67",
+  "version": "0.1.68",
   "description": "Zero-setup durable creative-media CLI for agents (image + video + audio + 3D): guide-first creation, model and cost inspection, owned URLs, JSON recovery, payments, reusable assets, and feedback.",
   "type": "module",
   "private": false,