image-skill 0.1.31 → 0.1.33

package/CHANGELOG.md

@@ -4,6 +4,24 @@ This changelog tracks the public `image-skill` CLI package and public skill
 mirror. The npm package metadata remains the authority for tarball integrity and
 provenance; this file is the human- and agent-readable release map.
 
+## 0.1.33 - 2026-06-04
+
+- Fix (guide): public `create --guide` replay commands now preserve explicit
+  `--model`, `--provider`, `--intent`, and
+  `--max-estimated-usd-per-image` context in `after_next`, auth rerun, and
+  self-fund handoff commands. Modality-specific aliases can send an agent
+  through signup or quota recovery without silently falling back to the default
+  image guide.
+
+## 0.1.32 - 2026-06-04
+
+- Fix (payments): public `create --guide` payment suggestions and
+  `credits methods` recovery commands now emit copy-runnable
+  `npx -y image-skill@latest` commands that preserve
+  `IMAGE_SKILL_CONFIG_PATH` when agents use a non-default config path. The
+  self-fund quote/buy/status path no longer drops auth context after a fresh
+  `npx` invocation.
+
 ## 0.1.31 - 2026-06-03
 
 - Fix (guide): public `create --guide` copyable commands now preserve

package/bin/image-skill.mjs

@@ -7,7 +7,7 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import os from "node:os";
 
-const VERSION = "0.1.31";
+const VERSION = "0.1.33";
 const PACKAGE_NAME = "image-skill";
 const DEFAULT_API_BASE_URL = "https://api.image-skill.com";
 const DEFAULT_DOCS_BASE_URL = "https://image-skill.com";
@@ -918,12 +918,15 @@ async function credits(argv) {
     if (tokenHandoff !== null) {
       return tokenHandoff;
     }
-    return apiRequest({
-      command: "image-skill credits methods",
-      method: "GET",
-      apiBaseUrl: apiBase(args),
-      path: "/v1/payment-methods",
-    });
+    return withCopyRunnablePaymentMethodCommands(
+      await apiRequest({
+        command: "image-skill credits methods",
+        method: "GET",
+        apiBaseUrl: apiBase(args),
+        path: "/v1/payment-methods",
+      }),
+      createGuideCommandPrefix(),
+    );
   }
   if (subcommand === "packs") {
     const [packsSubcommand, ...packsRest] = rest;
@@ -1397,7 +1400,8 @@ async function createGuide(args) {
   const trimmedPrompt = prompt.trim();
   const requestedModelId = flagString(args, "model");
   const requestedProviderId = flagString(args, "provider");
-  const requestedIntent = flagString(args, "intent") ?? "explore";
+  const requestedIntentFlag = flagString(args, "intent");
+  const requestedIntent = requestedIntentFlag ?? "explore";
   const maxEstimatedUsdPerImage = flagNumber(
     args,
     "max-estimated-usd-per-image",
@@ -1460,7 +1464,6 @@ async function createGuide(args) {
   const authenticated = quota?.envelope.data?.authenticated === true;
   const publicTokenSource =
     token.source === "anonymous" ? "none" : token.source;
-  const paymentSummary = createGuidePaymentSummary(payments.envelope.data);
   const stage = createGuideStage({
     prompt: trimmedPrompt,
     health,
@@ -1478,6 +1481,10 @@ async function createGuide(args) {
         ? LOCAL_WRITABLE_CONFIG_PATH
         : configuredImageSkillConfigPath(),
   });
+  const paymentSummary = createGuidePaymentSummary(
+    payments.envelope.data,
+    guideCommandPrefix,
+  );
   const blocker = createGuideBlocker(stage, {
     requestedModelId,
     quota,
@@ -1488,6 +1495,9 @@ async function createGuide(args) {
     selected,
     requestedProviderId,
     requestedIntent,
+    requestedIntentFlag,
+    requestedModelId,
+    maxEstimatedUsdPerImage,
     budgetGuard,
     aspectRatio: selectedAspectRatio,
     apiBaseUrl: explicitApiBaseUrl(args),
@@ -1500,6 +1510,9 @@ async function createGuide(args) {
     selected,
     requestedProviderId,
     requestedIntent,
+    requestedIntentFlag,
+    requestedModelId,
+    maxEstimatedUsdPerImage,
     budgetGuard,
     aspectRatio: selectedAspectRatio,
     apiBaseUrl: explicitApiBaseUrl(args),
@@ -1539,6 +1552,12 @@ async function createGuide(args) {
           trimmedPrompt,
           explicitApiBaseUrl(args),
           guideCommandPrefix,
+          {
+            modelId: requestedModelId,
+            providerId: requestedProviderId,
+            intent: requestedIntentFlag,
+            maxEstimatedUsdPerImage,
+          },
         )
       : null;
   const authHandoff = createGuideAuthHandoff(stage, {
@@ -1875,7 +1894,7 @@ function createGuideSelectionReason(model, prompt, intent) {
   return "guide selected the first available executable create model";
 }
 
-function createGuidePaymentSummary(data) {
+function createGuidePaymentSummary(data, commandPrefix) {
   const methods = Array.isArray(data?.methods)
     ? data.methods.filter((method) => method.live_money)
     : [];
@@ -1933,6 +1952,7 @@ function createGuidePaymentSummary(data) {
     suggested_commands: createGuidePaymentCommands(
       preferredMethod,
       availableMethods.filter((method) => method !== preferredMethod),
+      commandPrefix,
     ),
   };
 }
@@ -1995,7 +2015,11 @@ function createGuidePreferredPaymentSummary(method) {
   };
 }
 
-function createGuidePaymentCommands(preferredMethod, fallbackMethods) {
+function createGuidePaymentCommands(
+  preferredMethod,
+  fallbackMethods,
+  commandPrefix,
+) {
   const commands = [
     "image-skill credits methods --json",
     "image-skill credits packs list --json",
@@ -2017,7 +2041,68 @@ function createGuidePaymentCommands(preferredMethod, fallbackMethods) {
       }
     }
   }
-  return commands;
+  return commands.map((command) =>
+    renderCopyRunnablePaymentCommand(commandPrefix, command),
+  );
+}
+
+function withCopyRunnablePaymentMethodCommands(result, commandPrefix) {
+  const data = result.envelope.data;
+  if (data === null || typeof data !== "object") {
+    return result;
+  }
+  return {
+    ...result,
+    envelope: {
+      ...result.envelope,
+      data: paymentMethodCatalogWithCopyRunnableCommands(data, commandPrefix),
+    },
+  };
+}
+
+function paymentMethodCatalogWithCopyRunnableCommands(catalog, commandPrefix) {
+  return {
+    ...catalog,
+    methods: Array.isArray(catalog.methods)
+      ? catalog.methods.map((method) => ({
+          ...method,
+          recovery:
+            method.recovery === null || typeof method.recovery !== "object"
+              ? method.recovery
+              : {
+                  ...method.recovery,
+                  quote_command:
+                    typeof method.recovery.quote_command === "string"
+                      ? renderCopyRunnablePaymentCommand(
+                          commandPrefix,
+                          method.recovery.quote_command,
+                        )
+                      : method.recovery.quote_command,
+                  purchase_command:
+                    typeof method.recovery.purchase_command === "string"
+                      ? renderCopyRunnablePaymentCommand(
+                          commandPrefix,
+                          method.recovery.purchase_command,
+                        )
+                      : method.recovery.purchase_command,
+                  status_command:
+                    typeof method.recovery.status_command === "string"
+                      ? renderCopyRunnablePaymentCommand(
+                          commandPrefix,
+                          method.recovery.status_command,
+                        )
+                      : method.recovery.status_command,
+                },
+        }))
+      : catalog.methods,
+  };
+}
+
+function renderCopyRunnablePaymentCommand(commandPrefix, command) {
+  if (/\bnpx\s+(?:-y|--yes)\s+image-skill@latest\b/.test(command)) {
+    return command;
+  }
+  return renderGuidePrefixedCommand(commandPrefix, command);
 }
 
 function createGuideStage(input) {
@@ -2217,7 +2302,6 @@ function createGuideSelfFundHandoff(stage, input) {
   const statusCommand = guidePaymentCommandByKind(
     input.paymentSummary.suggested_commands,
     "status",
-    input.commandPrefix,
   );
 
   return {
@@ -2234,12 +2318,10 @@ function createGuideSelfFundHandoff(stage, input) {
       quote: guidePaymentCommandByKind(
         input.paymentSummary.suggested_commands,
         "quote",
-        input.commandPrefix,
       ),
       buy: guidePaymentCommandByKind(
         input.paymentSummary.suggested_commands,
         "buy",
-        input.commandPrefix,
       ),
       status: statusCommand,
     },
@@ -2498,7 +2580,12 @@ function createGuideWarning(stage, input) {
 
 function createGuideNextCommand(stage, input) {
   if (stage === "prompt_required") {
-    return renderGuideCommand("PROMPT", input.apiBaseUrl, input.commandPrefix);
+    return renderGuideCommand("PROMPT", input.apiBaseUrl, input.commandPrefix, {
+      modelId: input.requestedModelId,
+      providerId: input.requestedProviderId,
+      intent: input.requestedIntentFlag,
+      maxEstimatedUsdPerImage: input.maxEstimatedUsdPerImage,
+    });
   }
   if (stage === "no_executable_model" || stage === "service_unreachable") {
     return renderGuidePrefixedCommand(
@@ -2510,11 +2597,9 @@ function createGuideNextCommand(stage, input) {
     return renderGuideSignupCommand(input);
   }
   if (stage === "quota_required") {
-    return renderGuidePrefixedCommand(
-      input.commandPrefix,
-      stripImageSkillCommandPrefix(
-        firstPaymentActionCommand(input.paymentSummary.suggested_commands),
-      ),
+    return (
+      firstPaymentActionCommand(input.paymentSummary.suggested_commands) ??
+      renderGuidePrefixedCommand(input.commandPrefix, "credits methods --json")
     );
   }
   if (createGuideSelectedModelRequiresInputImage(input.selected)) {
@@ -2590,11 +2675,38 @@ function createGuideEscapeHatches(input) {
   };
 }
 
-function renderGuideCommand(prompt, apiBaseUrl, commandPrefix = "image-skill") {
+function renderGuideCommand(
+  prompt,
+  apiBaseUrl,
+  commandPrefix = "image-skill",
+  options = {},
+) {
   return [
     commandPrefix,
     "create --guide --prompt",
     shellQuote(prompt),
+    ...(options.modelId === null ||
+    options.modelId === undefined ||
+    options.modelId === ""
+      ? []
+      : ["--model", shellQuote(options.modelId)]),
+    ...(options.providerId === null ||
+    options.providerId === undefined ||
+    options.providerId === ""
+      ? []
+      : ["--provider", shellQuote(options.providerId)]),
+    ...(options.intent === null ||
+    options.intent === undefined ||
+    options.intent === ""
+      ? []
+      : ["--intent", shellQuote(options.intent)]),
+    ...(options.maxEstimatedUsdPerImage === null ||
+    options.maxEstimatedUsdPerImage === undefined
+      ? []
+      : [
+          "--max-estimated-usd-per-image",
+          shellQuote(formatUsd(options.maxEstimatedUsdPerImage)),
+        ]),
     ...(apiBaseUrl === null ? [] : ["--api-base-url", shellQuote(apiBaseUrl)]),
     "--json",
   ].join(" ");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "image-skill",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "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,