@clickraft/cli 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,16 +1,10 @@
-## [0.13.0](https://github.com/clickraft/cli/compare/v0.12.0...v0.13.0) (2026-08-08)
+## [0.14.0](https://github.com/clickraft/cli/compare/v0.13.0...v0.14.0) (2026-09-25)
 
 ### Features
 
-* **cli:** add product create ([fe46251](https://github.com/clickraft/cli/commit/fe4625100ae9af7571e0b97156d58eba59e9aea1))
-* **cli:** request products:write at login and degrade when the server refuses it ([a8b6db2](https://github.com/clickraft/cli/commit/a8b6db24d2789df834bffdf6290cb1bebd41116c))
-* **errors:** recognize the five product-create error codes ([9e0aef4](https://github.com/clickraft/cli/commit/9e0aef4a3eb0cf188b1016f70b7c326b14b7cd8b))
-* **mcp:** add the product_create tool ([f725172](https://github.com/clickraft/cli/commit/f725172c9df13af80c244c93506036c178008284))
-* **sdk:** add the product create request contract ([75ae3c7](https://github.com/clickraft/cli/commit/75ae3c78b011b5278a21da75d247e7452e2c630c))
-
-### Bug Fixes
-
-* **cli:** point the insufficient-scope hint at login --force-reauth ([398abd3](https://github.com/clickraft/cli/commit/398abd3ba7928706faf7f505038c4b52361b4a68))
+* **cli:** add --quality to generate create ([1497837](https://github.com/clickraft/cli/commit/149783789b272eeeb879a0b83e18522c6d7ced37))
+* **mcp:** add quality to generate_create ([72e8232](https://github.com/clickraft/cli/commit/72e82323005efc7f535d6c7708d43c107e721229))
+* **sdk:** accept a quality tier in the generate create contract ([3ef37ec](https://github.com/clickraft/cli/commit/3ef37ec4bfba289ee46d08cdac88beeff769798d))
 
 # Changelog
 

package/README.md

@@ -45,6 +45,16 @@ clickraft generate create --model-slug nano-banana-2 \
 
 > **Note:** `--brand-model` only works with reference-supporting models (nano-banana-2 recommended).
 
+### Quality
+
+Use `--quality` to pick a model's quality tier. Lower tiers cost fewer credits. Valid values depend on the model (GPT Image 2.5 offers `low`, `medium`, `high`, `xhigh` and `max`). Omit it to use the model default. An unsupported value is rejected before any charge, and the error lists the values the model accepts:
+
+```bash
+clickraft generate create --model-slug gpt-image-2.5-flare \
+  --prompt "product on marble" \
+  --quality low
+```
+
 ### Products
 
 Create a product from images you have already uploaded, then generate against it:

package/dist/cli.js

@@ -235,6 +235,10 @@ var GenerateCreateRequestSchema = z6.object({
       "resolution must match WxH (e.g. 1280x720), p-token (e.g. 720p), or K-token (e.g. 1K)"
     ).optional(),
     durationSeconds: z6.number().int().min(1).max(60).optional(),
+    // The model's quality tier (e.g. 'low' | 'medium' | 'high'). The valid set is
+    // per model, so it is checked server-side: an unoffered value returns 400
+    // INPUT_INVALID_FORMAT with the supported options in `details.allowed`.
+    quality: z6.string().min(1).max(40).optional(),
     width: z6.number().int().min(64).max(8192).optional(),
     height: z6.number().int().min(64).max(8192).optional(),
     providerParams: z6.record(z6.string(), z6.unknown()).optional()
@@ -2245,6 +2249,7 @@ function buildRequestBody(args) {
   if (args.aspectRatio !== void 0) input.aspectRatio = args.aspectRatio;
   if (args.resolution !== void 0) input.resolution = args.resolution;
   if (args.durationSeconds !== void 0) input.durationSeconds = args.durationSeconds;
+  if (args.quality !== void 0) input.quality = args.quality;
   if (args.brandModels !== void 0 && args.brandModels.length > 0) {
     input.providerParams = {
       brandModels: args.brandModels.map((spec) => {
@@ -4627,6 +4632,7 @@ function renderCommandHelp(command) {
         "  --aspect-ratio <a:b>      e.g. 16:9",
         "  --resolution <size>       e.g. 1024x768, 720p, 1K",
         "  --duration-seconds <n>    For video/audio models (1-60)",
+        "  --quality <tier>          e.g. low, medium, high (valid values depend on the model)",
         "  --workflow-id <uuid>      Attach to an existing workflow",
         "  --node-id <id>            Attach to a specific node",
         "  --no-wait, --async        Return immediately with the jobId",
@@ -4945,6 +4951,7 @@ async function runGenerateCreate(argv, ctx, rc) {
       "aspect-ratio",
       "resolution",
       "duration-seconds",
+      "quality",
       "workflow-id",
       "node-id",
       "timeout"
@@ -4968,6 +4975,7 @@ async function runGenerateCreate(argv, ctx, rc) {
     aspectRatio: parsed.string["aspect-ratio"],
     resolution: parsed.string.resolution,
     durationSeconds: optionalInt(parsed.string["duration-seconds"], "duration-seconds"),
+    quality: parsed.string.quality,
     brandModels,
     products,
     workflowId: parsed.string["workflow-id"],