luxin-cli 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -6,6 +6,26 @@ provenance; this file is the human- and agent-readable release map.
 
 ## Unreleased
 
+## 0.2.7 - 2026-08-12
+
+- Release (pricing): the guide's local credit quoting for xAI models moved from
+  a `startsWith("xai.grok-imagine-image")` prefix test to an explicit model-id
+  list. The prefix test would have priced any Grok Imagine model it had never
+  heard of off the 1.x table — for the new `xai.grok-imagine-image-2.0` that
+  meant quoting 4 credits for a 10-credit create. Models outside the list now
+  defer to the hosted registry's published debit instead of guessing.
+- Adds the `xai.grok-imagine-image-2.0` quality×resolution credit matrix to
+  local guide pricing (low/1k through medium/2k), matching the registry the
+  hosted API serves since 2026-08-12. Every tier was verified against live
+  provider billing before release ($0.04/$0.06/$0.07/$0.08 receipts).
+- The registry behind `models show` grew from 290 to 316 models server-side
+  (grok-imagine-image-2.0 create+edit executable and listed; 24 summer-wave
+  fal models cataloged with honest tier pricing before they are wired —
+  reachable via `models show MODEL_ID`, not yet in the `models list` output,
+  which serves executable models only). No CLI change was needed for that —
+  noted here because agents read this file to decide whether to upgrade:
+  upgrade for the pricing fix, not for model availability.
+
 ## 0.2.6 - 2026-08-09
 
 - Release (trust): `create --guide` now says when it cannot price the request it

package/bin/luxin.mjs

@@ -15,7 +15,7 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import os from "node:os";
 
-const VERSION = "0.2.6";
+const VERSION = "0.2.7";
 const PACKAGE_NAME = "luxin";
 const DEFAULT_API_BASE_URL = "https://api.luxin.sh";
 const DEFAULT_DOCS_BASE_URL = "https://luxin.sh";
@@ -101,12 +101,28 @@ const ACCEPTED_PUBLIC_MEDIA_HOSTS = [
 // price. These are prices, not costs: the CLI never computes or publishes
 // provider cost or margin.
 const XAI_IMAGE_CREDIT_PRICES = {
-  source_image: { standard: 1 / 3, quality: 5 / 3 },
+  source_image: { standard: 1 / 3, quality: 5 / 3, image_2: 5 / 3 },
   output_image: {
     standard: 10 / 3,
     quality: { "1k": 25 / 3, "2k": 35 / 3 },
+    image_2: {
+      low: { "1k": 20 / 3, "2k": 10 },
+      medium: { "1k": 10, "2k": 40 / 3 },
+    },
   },
 };
+// Mirrors src/credit-pricing.ts XAI_IMAGE_MODEL_IDS. This is an explicit list,
+// not a prefix test: a Grok Imagine image model this CLI has never heard of is
+// priced by the hosted registry's published debit, not by guessing it onto the
+// 1.x price table.
+const XAI_LOCALLY_PRICED_IMAGE_MODEL_IDS = new Set([
+  "xai.grok-imagine-image",
+  "xai.grok-imagine-image-edit",
+  "xai.grok-imagine-image-quality",
+  "xai.grok-imagine-image-quality-edit",
+  "xai.grok-imagine-image-2.0",
+  "xai.grok-imagine-image-2.0-edit",
+]);
 const MODALITY_COMMAND_ALIASES = new Map([
   ["image", { command: "create", intent: null }],
   ["video", { command: "create", intent: "video" }],
@@ -3039,14 +3055,16 @@ function createGuideAspectRatioCreditPricing(model, context) {
 }
 
 function createGuideCanPriceModelParameters(model) {
-  return String(model?.id ?? "").startsWith("xai.grok-imagine-image");
+  return XAI_LOCALLY_PRICED_IMAGE_MODEL_IDS.has(String(model?.id ?? ""));
 }
 
 function createGuideXaiImagePricing(model, modelParameters, context) {
   const modelId = String(model?.id ?? "");
   const quality = modelId.includes("-quality");
+  const image2 = modelId.startsWith("xai.grok-imagine-image-2.0");
   const edit = modelId.endsWith("-edit");
   const resolution = modelParameters?.resolution === "2k" ? "2k" : "1k";
+  const image2Quality = modelParameters?.quality === "low" ? "low" : "medium";
   const outputImageCount =
     Number.isInteger(context?.outputCount) && context.outputCount > 0
       ? context.outputCount
@@ -3057,12 +3075,16 @@ function createGuideXaiImagePricing(model, modelParameters, context) {
       ? context.referenceAssetCount
       : 0;
   const sourceImageCount = edit ? 1 + referenceAssetCount : 0;
-  const sourceCredits = quality
-    ? XAI_IMAGE_CREDIT_PRICES.source_image.quality
-    : XAI_IMAGE_CREDIT_PRICES.source_image.standard;
-  const outputCredits = quality
-    ? XAI_IMAGE_CREDIT_PRICES.output_image.quality[resolution]
-    : XAI_IMAGE_CREDIT_PRICES.output_image.standard;
+  const sourceCredits = image2
+    ? XAI_IMAGE_CREDIT_PRICES.source_image.image_2
+    : quality
+      ? XAI_IMAGE_CREDIT_PRICES.source_image.quality
+      : XAI_IMAGE_CREDIT_PRICES.source_image.standard;
+  const outputCredits = image2
+    ? XAI_IMAGE_CREDIT_PRICES.output_image.image_2[image2Quality][resolution]
+    : quality
+      ? XAI_IMAGE_CREDIT_PRICES.output_image.quality[resolution]
+      : XAI_IMAGE_CREDIT_PRICES.output_image.standard;
   const creditsRequired = Math.max(
     1,
     Math.ceil(
@@ -3075,8 +3097,14 @@ function createGuideXaiImagePricing(model, modelParameters, context) {
     modelParameters?.resolution === undefined ||
     modelParameters?.resolution === null ||
     modelParameters?.resolution === "1k";
+  const defaultQuality =
+    !image2 ||
+    modelParameters?.quality === undefined ||
+    modelParameters?.quality === null ||
+    modelParameters?.quality === "medium";
   const defaultShape =
     defaultResolution &&
+    defaultQuality &&
     outputImageCount === 1 &&
     sourceImageCount === (edit ? 1 : 0);
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luxin-cli",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Image generation, image editing, video, audio, and image-to-3D for agents, with no API key to obtain first. The agent signs itself up, starts on free preview credits, and gets hosted media URLs, recoverable jobs, and cost receipts.",
   "type": "module",
   "private": false,