image-skill 0.1.39 → 0.1.41

package/CHANGELOG.md

@@ -4,6 +4,28 @@ 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.41 - 2026-06-12
+
+- Fix (activation): `create --guide` now selects executable models from the
+  compact default `/v1/models` response. The guide no longer reports
+  `no_executable_model` while the same response says executable models exist;
+  it preserves compact-row execution status, pricing, aspect-ratio fallback,
+  and input-image hints so the first no-spend dry-run handoff is usable again.
+- Fix (payments): Stripe Checkout handoff URLs now keep redirecting to the
+  stored Stripe Checkout URL for non-expired fulfilled attempts instead of
+  surfacing the misleading plain-text `handoff database read failed` page after
+  webhook fulfillment.
+
+## 0.1.40 - 2026-06-11
+
+- Fix (growth): the `IMAGE_SKILL_DISCOVERY_SOURCE` attribution slug now
+  survives the guide handoff — guide-emitted fresh-process replay commands
+  (including the signup `next_command`) carry the env assignment in their
+  shell prefix, the same fresh-process-env treatment as
+  `IMAGE_SKILL_CONFIG_PATH`. Without this, a slug provided at
+  `create --guide` was lost before signup, so channel attribution read zero
+  by construction.
+
 ## 0.1.39 - 2026-06-10
 
 - Feature (growth): **`signup --discovery-source SLUG`** (or the

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.39";
+const VERSION = "0.1.41";
 const PACKAGE_NAME = "image-skill";
 const DEFAULT_API_BASE_URL = "https://api.image-skill.com";
 const DEFAULT_DOCS_BASE_URL = "https://image-skill.com";
@@ -1652,12 +1652,15 @@ async function createGuide(args) {
         })
       : null;
   const selectedAspectRatio = createGuideSuggestedAspectRatio(selected);
-  const pricing = selected?.economics?.credit_pricing ?? null;
+  const pricing = createGuideModelCreditPricing(selected);
   const estimatedCredits = pricing?.credits_required ?? null;
   const estimatedProviderUsdPerImage =
     selected?.economics?.estimated_usd_per_image ??
     pricing?.estimated_provider_cost_usd ??
     pricing?.fallback_provider_cost_usd ??
+    (typeof selected?.estimated_usd_per_image === "number"
+      ? selected.estimated_usd_per_image
+      : null) ??
     null;
   const estimatedDebitUsdPerImage =
     pricing?.estimated_revenue_usd ?? estimatedProviderUsdPerImage;
@@ -1856,7 +1859,7 @@ async function createGuide(args) {
               : "create",
             model_id: selected.id,
             model_status: selected.status,
-            model_execution_status: selected.execution.model_execution_status,
+            model_execution_status: guideModelExecutionStatus(selected),
             modality: selected.modality ?? null,
             suggested_aspect_ratio: selectedAspectRatio,
             reason:
@@ -1924,12 +1927,12 @@ function selectCreateGuideModel(
 ) {
   const isExecutableCreate = (model) =>
     model?.status === "available" &&
-    model?.execution?.model_execution_status === "executable" &&
+    guideModelExecutionStatus(model) === "executable" &&
     Array.isArray(model?.supports) &&
     model.supports.includes("create");
   const isExecutableInputImageEdit = (model) =>
     model?.status === "available" &&
-    model?.execution?.model_execution_status === "executable" &&
+    guideModelExecutionStatus(model) === "executable" &&
     Array.isArray(model?.supports) &&
     (model.supports.includes("edit") || model.supports.includes("variation")) &&
     createGuideSelectedModelRequiresInputImage(model);
@@ -2036,16 +2039,57 @@ function preferredCreateGuideModelIds(intentClass) {
 }
 
 function guideBudgetUsdForModel(model) {
-  const pricing = model?.economics?.credit_pricing ?? null;
+  const pricing = createGuideModelCreditPricing(model);
   return (
     pricing?.estimated_revenue_usd ??
     model?.economics?.estimated_usd_per_image ??
     pricing?.estimated_provider_cost_usd ??
     pricing?.fallback_provider_cost_usd ??
+    (typeof model?.estimated_usd_per_image === "number"
+      ? model.estimated_usd_per_image
+      : null) ??
     null
   );
 }
 
+function guideModelExecutionStatus(model) {
+  if (
+    isRecord(model?.execution) &&
+    typeof model.execution.model_execution_status === "string"
+  ) {
+    return model.execution.model_execution_status;
+  }
+  return typeof model?.model_execution_status === "string"
+    ? model.model_execution_status
+    : null;
+}
+
+function createGuideModelCreditPricing(model) {
+  if (isRecord(model?.economics?.credit_pricing)) {
+    return model.economics.credit_pricing;
+  }
+  if (typeof model?.credits_required !== "number") {
+    return null;
+  }
+  return {
+    credits_required: model.credits_required,
+    estimated_revenue_usd:
+      typeof model.credits_required === "number"
+        ? model.credits_required * CREDIT_UNIT_USD
+        : null,
+    estimated_provider_cost_usd:
+      typeof model?.estimated_usd_per_image === "number"
+        ? model.estimated_usd_per_image
+        : null,
+    fallback_provider_cost_usd: null,
+    credit_unit_usd: CREDIT_UNIT_USD,
+    pricing_confidence:
+      typeof model?.pricing_confidence === "string"
+        ? model.pricing_confidence
+        : null,
+  };
+}
+
 function createGuideImplies3d(input) {
   const searchable =
     `${input?.intent ?? ""} ${input?.prompt ?? ""}`.toLowerCase();
@@ -2077,7 +2121,9 @@ function createGuideSuggestedAspectRatio(model) {
   if (model?.modality !== "video") {
     return null;
   }
-  const values = model?.media?.input?.aspect_ratios?.values;
+  const values = Array.isArray(model?.media?.input?.aspect_ratios?.values)
+    ? model.media.input.aspect_ratios.values
+    : model?.aspect_ratios;
   if (!Array.isArray(values)) {
     return null;
   }
@@ -2086,7 +2132,8 @@ function createGuideSuggestedAspectRatio(model) {
 
 function createGuideSelectedModelRequiresInputImage(model) {
   return (
-    model?.media?.input?.images?.required === true &&
+    (model?.media?.input?.images?.required === true ||
+      model?.accepts_input_images === true) &&
     Array.isArray(model?.supports) &&
     (model.supports.includes("edit") || model.supports.includes("variation"))
   );
@@ -3098,15 +3145,28 @@ function createGuideCommandPrefix(input = {}) {
     input.configPath === undefined
       ? configuredImageSkillConfigPath()
       : input.configPath;
+  // Discovery-source attribution (#1814) must survive the guide handoff into
+  // the fresh-process replay commands, or the slug dies before signup.
+  const discoverySource = configuredDiscoverySource();
   return renderShellEnvPrefixedCommand(
     {
       npm_config_update_notifier: "false",
       ...(configPath === null ? {} : { IMAGE_SKILL_CONFIG_PATH: configPath }),
+      ...(discoverySource === null
+        ? {}
+        : { IMAGE_SKILL_DISCOVERY_SOURCE: discoverySource }),
     },
     "npx -y image-skill@latest",
   );
 }
 
+function configuredDiscoverySource() {
+  const value = process.env.IMAGE_SKILL_DISCOVERY_SOURCE;
+  return typeof value === "string" && value.trim().length > 0
+    ? value.trim()
+    : null;
+}
+
 function configuredImageSkillConfigPath() {
   const configPath = process.env.IMAGE_SKILL_CONFIG_PATH;
   return typeof configPath === "string" && configPath.length > 0
@@ -4370,6 +4430,9 @@ function modelAvailabilityStatus(model) {
   ) {
     return model.execution.model_execution_status;
   }
+  if (typeof model.model_execution_status === "string") {
+    return model.model_execution_status;
+  }
   if (typeof model.availability_reason === "string") {
     return model.availability_reason;
   }

package/package.json

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