image-skill 0.1.52 → 0.1.54

package/CHANGELOG.md

@@ -4,6 +4,25 @@ 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.54 - 2026-06-16
+
+- Release (activation/self-fund): add explicit `urgency`,
+  `urgency_score`, and `urgency_reasons` to quota top-up data and
+  `data.next_actions.self_fund`, so activated agents can distinguish
+  browserless top-up availability from near-wall or blocked top-up urgency
+  without reverse-engineering recommendation reasons. No payment caps, auth
+  semantics, provider routing, wallet action, provider spend, media spend,
+  hosted deploy, or production write changed in this release bump.
+
+## 0.1.53 - 2026-06-16
+
+- Release (activation): align `create --guide` `auth_required` blocker copy
+  with anonymous signup semantics. Fresh agents are told to sign up once, with
+  `--agent-contact` optional and attachable later, instead of implying that a
+  durable contact inbox is required before hosted media creation. No auth
+  semantics, token storage, payment caps, provider routing, provider spend,
+  media spend, hosted deploy, or production write changed in this release bump.
+
 ## 0.1.52 - 2026-06-16
 
 - Release (activation/self-fund): publish the quota

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.52";
+const VERSION = "0.1.54";
 const PACKAGE_NAME = "image-skill";
 const DEFAULT_API_BASE_URL = "https://api.image-skill.com";
 const DEFAULT_DOCS_BASE_URL = "https://image-skill.com";
@@ -2776,7 +2776,7 @@ function createGuideBlocker(stage, input) {
     return {
       code: "auth_required",
       message:
-        "Sign up once with a durable agent contact before creating hosted media.",
+        "Sign up once before creating hosted media; --agent-contact is optional and can be attached later.",
     };
   }
   if (stage === "quota_required") {
@@ -6132,6 +6132,7 @@ function quotaTopUpNextActions(topUp) {
       available: true,
       recommended: topUp.recommended === true,
       recommendation_reason: topUp.recommendation_reason ?? "available",
+      ...quotaTopUpUrgencyFields(topUp),
       path: topUp.path,
       first_safe_command: commands.inspect_methods,
       first_safe_command_effect: {
@@ -6162,6 +6163,44 @@ function quotaTopUpNextActions(topUp) {
   };
 }
 
+function quotaTopUpUrgencyFields(topUp) {
+  const reason = topUp?.recommendation_reason ?? "available";
+  const fallback = quotaTopUpUrgencyFromReason(reason);
+  const urgency =
+    typeof topUp?.urgency === "string" && topUp.urgency.length > 0
+      ? topUp.urgency
+      : fallback.urgency;
+  const urgencyScore =
+    typeof topUp?.urgency_score === "number"
+      ? topUp.urgency_score
+      : fallback.score;
+  const urgencyReasons = Array.isArray(topUp?.urgency_reasons)
+    ? topUp.urgency_reasons
+        .filter((entry) => typeof entry === "string" && entry.length > 0)
+        .map((entry) => entry)
+    : reason === "available"
+      ? []
+      : [reason];
+  return {
+    urgency,
+    urgency_score: urgencyScore,
+    urgency_reasons: urgencyReasons,
+  };
+}
+
+function quotaTopUpUrgencyFromReason(reason) {
+  if (reason === "credits_depleted" || reason === "daily_job_cap_reached") {
+    return { urgency: "blocked", score: 100 };
+  }
+  if (reason === "low_remaining_credits") {
+    return { urgency: "near_wall", score: 80 };
+  }
+  if (reason === "self_fund_setup_missing") {
+    return { urgency: "setup_recommended", score: 60 };
+  }
+  return { urgency: "available", score: 0 };
+}
+
 function failure(command, exitCode, code, message, retryable, recovery) {
   return {
     exitCode,

package/package.json

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