@koda-sl/baker-cli 0.148.0 → 0.149.0

package/dist/cli.js

@@ -24,6 +24,7 @@ import {
   imageProfileFor,
   isPersistedAssetRef,
   looksLikeHttpUrl,
+  nearestSupportedAspectRatio,
   parseRefExpr,
   platformFormats,
   requireCredentialsFromEnv,
@@ -31,10 +32,11 @@ import {
   sha256Hex,
   spineInputFlags,
   spineInputOps,
+  supportsParam,
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-2F5SCTNS.js";
+} from "./chunk-OO5BDH3J.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -2707,8 +2709,9 @@ var rgbTriple = z8.tuple([
   z8.number().int().min(0).max(255)
 ]);
 var imageGenerateModelSchema = z8.enum([
+  "openai/gpt-image-2",
+  // Legacy — see the registry entry; kept so pre-switch canvases still run.
   "openai/gpt-5.4-image-2",
-  "google/gemini-3.5-flash",
   "google/gemini-3.1-flash-image-preview",
   "google/gemini-3-pro-image-preview",
   "recraft/recraft-v4.1-pro-vector"
@@ -16653,7 +16656,9 @@ function buildFrameRef(edge, url, framePrompt, present2, ctx, nodes) {
   const imageProfile = imageProfileFor(ctx.imageModel);
   const genParams = {
     model: ctx.imageModel,
-    image_size: "2K",
+    // gpt-image-2 derives pixel dimensions from the ratio and has no size knob,
+    // so asking for 2K there is an `unknown_param` at validate.
+    ...supportsParam("image_generate", ctx.imageModel, "image_size") ? { image_size: "2K" } : {},
     // Per-model image defaults (gpt-image: quality=high — OpenRouter forwards it; we do
     // NOT send input_fidelity, which gpt-image-2 forces high automatically).
     ...imageProfile?.paramDefaults ?? {},
@@ -16668,7 +16673,7 @@ function buildFrameRef(edge, url, framePrompt, present2, ctx, nodes) {
       ctx.imageModel
     )
   };
-  if (ctx.genAr) genParams.aspect_ratio = ctx.genAr;
+  if (ctx.genAr) genParams.aspect_ratio = nearestSupportedAspectRatio("image_generate", ctx.imageModel, ctx.genAr);
   const genId = `s${ctx.sceneIndex}${tag}_${edge}`;
   nodes.push({
     id: genId,
@@ -20395,8 +20400,13 @@ function scaffoldStaticAd(input, elementsInput, opts) {
     inputs: { reference, target_blueprint: "$ref:prompt.asset" },
     params: {
       model: opts.genModel,
-      aspect_ratio: baseAspectRatio(blueprint, opts),
-      image_size: "2K",
+      // The hero renders at the closest ratio its model actually accepts; the
+      // placement fan-out below adapts it to the exact platform formats, which
+      // is also how a 4:5 Meta feed ad gets made on a model that has no 4:5.
+      aspect_ratio: nearestSupportedAspectRatio("image_generate", opts.genModel, baseAspectRatio(blueprint, opts)),
+      ...supportsParam("image_generate", opts.genModel, "image_size") ? { image_size: "2K" } : {},
+      // Per-model image defaults (gpt-image: quality=high).
+      ...imageProfileFor(opts.genModel)?.paramDefaults ?? {},
       prompt
     }
   });
@@ -20763,7 +20773,7 @@ function resolveModels(args) {
     describeModel: pick("describe-model", "image_describe", "~google/gemini-pro-latest"),
     selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
     layoutModel: pick("layout-model", "text_generate", "~google/gemini-flash-latest"),
-    genModel: pick("gen-model", "image_generate", "openai/gpt-5.4-image-2")
+    genModel: pick("gen-model", "image_generate", "openai/gpt-image-2")
   };
 }
 var PLATFORM_PLACEMENTS = {
@@ -21405,7 +21415,7 @@ function resolveModels2(args) {
     // Default to the strongest image model (matches the static-ad scaffold); the
     // frame generators need the most faithful text/identity reproduction. Override
     // with --image-model for a cheaper/faster pass.
-    imageModel: pick("image-model", "image_generate", "openai/gpt-5.4-image-2")
+    imageModel: pick("image-model", "image_generate", "openai/gpt-image-2")
   };
 }
 function hasPhotorealCast(elements) {
@@ -24115,7 +24125,7 @@ async function resolveReferences(spec) {
 var generateCommand = defineCommand114({
   meta: {
     name: "generate",
-    description: "Generate an image with AI and store it in the library (cost-tracked per request via OpenRouter usage). Models mirror the canvas: google/gemini-3.1-flash-image-preview (Nano Banana flash \u2014 default, fast, extreme aspect ratios) & google/gemini-3.5-flash (fast), google/gemini-3-pro-image-preview (Nano Banana Pro \u2014 highest fidelity), openai/gpt-5.4-image-2 (photoreal, cleanest in-image text, best for ad/landing reproduction), recraft/recraft-v4.1-pro-vector (vector/SVG-style with palette control). The result is auto-ingested (describe + embed), so the next `baker images library` query finds it. Pass --reference with image URLs and/or local file paths (Pinterest, stock, brand assets, sandbox files) to ground generation in reality.\n\nExamples:\n  baker images generate 'a friendly golden retriever sitting in a bright modern living room' --aspect-ratio 16:9\n  baker images generate 'hero shot of a matte black water bottle on marble' --model openai/gpt-5.4-image-2 --image-size 2K\n  baker images generate 'lifestyle photo matching this mood' --reference 'https://\u2026/ref1.jpg,https://\u2026/ref2.jpg'\n  baker images generate 'put this product on a marble countertop, soft daylight' --reference './src/brand/logos/product.png,./refs/kitchen-mood.jpg'\n  baker images generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
+    description: "Generate an image with AI and store it in the library (cost-tracked per request via OpenRouter usage). Models mirror the canvas: google/gemini-3.1-flash-image-preview (Nano Banana flash \u2014 default, fast, extreme aspect ratios), google/gemini-3-pro-image-preview (Nano Banana Pro \u2014 highest fidelity), openai/gpt-image-2 (photoreal, cleanest in-image text, best for ad/landing reproduction \u2014 no --image-size, and no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/SVG-style with palette control). The result is auto-ingested (describe + embed), so the next `baker images library` query finds it. Pass --reference with image URLs and/or local file paths (Pinterest, stock, brand assets, sandbox files) to ground generation in reality.\n\nExamples:\n  baker images generate 'a friendly golden retriever sitting in a bright modern living room' --aspect-ratio 16:9\n  baker images generate 'hero shot of a matte black water bottle on marble' --model openai/gpt-image-2 --aspect-ratio 3:2\n  baker images generate 'lifestyle photo matching this mood' --reference 'https://\u2026/ref1.jpg,https://\u2026/ref2.jpg'\n  baker images generate 'put this product on a marble countertop, soft daylight' --reference './src/brand/logos/product.png,./refs/kitchen-mood.jpg'\n  baker images generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
   },
   args: {
     prompt: { type: "positional", description: "What to generate", required: false },
@@ -24288,6 +24298,34 @@ var gifCommand = defineCommand116({
 
 // src/commands/images/google.ts
 import { defineCommand as defineCommand117 } from "citty";
+
+// src/commands/images/searchHints.ts
+var FALLBACK = {
+  stock: "Still empty \u2192 `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover \u2014 `--sources` is required, `find` alone searches the library only) or `baker images generate` to make the asset. Do not re-run this search with reshuffled flags.",
+  google: "Still empty \u2192 `baker images generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry."
+};
+function emptyResultHints({ provider, hitCount, activeFilters }) {
+  if (hitCount > 0) {
+    return [];
+  }
+  const hints = [];
+  if (activeFilters.length > 0) {
+    hints.push(
+      `No hits. Drop the filters before touching the query \u2014 ${activeFilters.join(", ")} narrowed this search and filter combinations are the usual cause of an empty result.`
+    );
+  }
+  hints.push(FALLBACK[provider]);
+  return hints;
+}
+function activeFilterFlags(args, candidates) {
+  return candidates.filter((flag) => args[flag] !== void 0 && args[flag] !== "").map((flag) => `--${flag}`);
+}
+
+// src/commands/images/google.ts
+var GOOGLE_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker images generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
 registerSchema({
   command: "images.google",
   description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
@@ -24358,10 +24396,18 @@ var googleCommand2 = defineCommand117({
       if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
       if (args.context) body.descriptionContext = args.context;
       const data = await apiPost("/api/images/google", body);
-      writeJson({ ok: true, data });
+      const hints = emptyResultHints({
+        provider: "google",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "size", "color", "safe"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        writeJson({
+          ok: false,
+          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
@@ -25719,6 +25765,10 @@ var stickerCommand = defineCommand126({
 
 // src/commands/images/stock.ts
 import { defineCommand as defineCommand127 } from "citty";
+var STOCK_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `baker images generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
 registerSchema({
   command: "images.stock",
   description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
@@ -25776,6 +25826,21 @@ registerSchema({
     }
   }
 });
+function buildStockRequest(query, args) {
+  const body = { query };
+  if (args.type) body.contentType = args.type;
+  if (args.orientation) body.orientation = args.orientation;
+  if (args.license) body.license = args.license;
+  if (args.color) body.color = args.color;
+  if (args.ai) body.aiGenerated = args.ai;
+  if (args.people) body.people = args.people;
+  if (args.order) body.order = args.order;
+  if (args.limit) body.limit = Number(args.limit);
+  if (args.page) body.page = Number(args.page);
+  if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+  if (args.context) body.descriptionContext = args.context;
+  return body;
+}
 var stockCommand = defineCommand127({
   meta: {
     name: "stock",
@@ -25806,23 +25871,23 @@ var stockCommand = defineCommand127({
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
         process.exit(1);
       }
-      const body = { query };
-      if (args.type) body.contentType = args.type;
-      if (args.orientation) body.orientation = args.orientation;
-      if (args.license) body.license = args.license;
-      if (args.color) body.color = args.color;
-      if (args.ai) body.aiGenerated = args.ai;
-      if (args.people) body.people = args.people;
-      if (args.order) body.order = args.order;
-      if (args.limit) body.limit = Number(args.limit);
-      if (args.page) body.page = Number(args.page);
-      if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
-      if (args.context) body.descriptionContext = args.context;
-      const data = await apiPost("/api/images/stock", body);
-      writeJson({ ok: true, data });
+      const data = await apiPost("/api/images/stock", buildStockRequest(query, args));
+      const hints = emptyResultHints({
+        provider: "stock",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "orientation", "license", "color", "ai", "people"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            fix: STOCK_ERROR_FIX
+          }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });