image-skill 0.1.30 → 0.1.32

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.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
+  `IMAGE_SKILL_CONFIG_PATH` when an agent uses a non-default config path, and
+  blocked-config recovery commands switch to the local writable fallback in the
+  emitted `npx image-skill@latest` command. Auth signup, rerun, escape hatch,
+  ready dry-run/create, and self-fund quote/buy/status commands all keep the
+  same config context so fresh tool processes do not silently lose auth.
+
 ## 0.1.30 - 2026-06-03
 
 - Fix (provenance): replace the stale version-stamped "Current Published

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.30";
+const VERSION = "0.1.32";
 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;
@@ -1460,7 +1463,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,
@@ -1472,6 +1474,16 @@ async function createGuide(args) {
   });
   const authConfigWrite =
     stage === "auth_required" ? await probeConfigWritable() : null;
+  const guideCommandPrefix = createGuideCommandPrefix({
+    configPath:
+      authConfigWrite?.ok === false
+        ? LOCAL_WRITABLE_CONFIG_PATH
+        : configuredImageSkillConfigPath(),
+  });
+  const paymentSummary = createGuidePaymentSummary(
+    payments.envelope.data,
+    guideCommandPrefix,
+  );
   const blocker = createGuideBlocker(stage, {
     requestedModelId,
     quota,
@@ -1486,7 +1498,7 @@ async function createGuide(args) {
     aspectRatio: selectedAspectRatio,
     apiBaseUrl: explicitApiBaseUrl(args),
     paymentSummary,
-    commandPrefix: PUBLIC_NPX_COMMAND_PREFIX,
+    commandPrefix: guideCommandPrefix,
     authConfigWritable: authConfigWrite?.ok ?? true,
   });
   const escapeHatches = createGuideEscapeHatches({
@@ -1497,7 +1509,7 @@ async function createGuide(args) {
     budgetGuard,
     aspectRatio: selectedAspectRatio,
     apiBaseUrl: explicitApiBaseUrl(args),
-    commandPrefix: PUBLIC_NPX_COMMAND_PREFIX,
+    commandPrefix: guideCommandPrefix,
   });
   const nextCommandEffect = createGuideNextCommandEffect(stage, {
     estimatedCredits,
@@ -1532,7 +1544,7 @@ async function createGuide(args) {
       ? renderGuideCommand(
           trimmedPrompt,
           explicitApiBaseUrl(args),
-          PUBLIC_NPX_COMMAND_PREFIX,
+          guideCommandPrefix,
         )
       : null;
   const authHandoff = createGuideAuthHandoff(stage, {
@@ -1551,6 +1563,7 @@ async function createGuide(args) {
     nextCommand,
     afterNext,
     tokenSource: publicTokenSource,
+    commandPrefix: guideCommandPrefix,
   });
   return createGuideSuccess(quota?.envelope.actor ?? null, {
     schema: "image-skill.create-guide.v1",
@@ -1868,7 +1881,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)
     : [];
@@ -1926,6 +1939,7 @@ function createGuidePaymentSummary(data) {
     suggested_commands: createGuidePaymentCommands(
       preferredMethod,
       availableMethods.filter((method) => method !== preferredMethod),
+      commandPrefix,
     ),
   };
 }
@@ -1988,7 +2002,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",
@@ -2010,7 +2028,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) {
@@ -2500,11 +2579,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)) {
@@ -2598,13 +2675,7 @@ function renderGuideSignupCommand(input) {
       : ["--api-base-url", shellQuote(input.apiBaseUrl)]),
     "--json",
   ].join(" ");
-  const command = renderGuidePrefixedCommand(
-    input.commandPrefix,
-    signupCommand,
-  );
-  return input.authConfigWritable === false
-    ? renderWritableConfigCommand(command)
-    : command;
+  return renderGuidePrefixedCommand(input.commandPrefix, signupCommand);
 }
 
 function renderTokenStdinCommand(command) {
@@ -2621,14 +2692,18 @@ function firstPaymentActionCommand(commands) {
   );
 }
 
-function guidePaymentCommandByKind(commands, kind) {
+function guidePaymentCommandByKind(commands, kind, commandPrefix = null) {
   const pattern =
     kind === "quote"
       ? /\bcredits\s+quote\b/
       : kind === "buy"
         ? /\bcredits\s+buy\b/
         : /\bcredits\s+status\b/;
-  return commands.find((command) => pattern.test(command)) ?? null;
+  const command = commands.find((candidate) => pattern.test(candidate)) ?? null;
+  if (command === null || commandPrefix === null) {
+    return command;
+  }
+  return renderGuidePrefixedCommand(commandPrefix, command);
 }
 
 function renderImageTo3dGuideCommand(input) {
@@ -2685,6 +2760,43 @@ function renderGuidePrefixedCommand(commandPrefix, command) {
   return `${commandPrefix} ${stripImageSkillCommandPrefix(command)}`;
 }
 
+function createGuideCommandPrefix(input = {}) {
+  const configPath =
+    input.configPath === undefined
+      ? configuredImageSkillConfigPath()
+      : input.configPath;
+  return renderShellEnvPrefixedCommand(
+    {
+      npm_config_update_notifier: "false",
+      ...(configPath === null ? {} : { IMAGE_SKILL_CONFIG_PATH: configPath }),
+    },
+    "npx -y image-skill@latest",
+  );
+}
+
+function configuredImageSkillConfigPath() {
+  const configPath = process.env.IMAGE_SKILL_CONFIG_PATH;
+  return typeof configPath === "string" && configPath.length > 0
+    ? configPath
+    : null;
+}
+
+function renderShellEnvPrefixedCommand(env, command) {
+  const assignments = Object.entries(env).map(
+    ([name, value]) => `${name}=${shellEnvAssignmentValue(name, value)}`,
+  );
+  return assignments.length === 0
+    ? command
+    : `${assignments.join(" ")} ${command}`;
+}
+
+function shellEnvAssignmentValue(name, value) {
+  if (name.startsWith("npm_config_") && /^(?:true|false|\d+)$/.test(value)) {
+    return value;
+  }
+  return shellQuote(value);
+}
+
 function renderWritableConfigCommand(command) {
   return `IMAGE_SKILL_CONFIG_PATH="${LOCAL_WRITABLE_CONFIG_PATH}" ${command}`;
 }

package/package.json

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