chatroom-cli 1.136.0 → 1.137.1

package/dist/index.js

@@ -2140,7 +2140,156 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
+// src/commands/generate/model-capabilities.ts
+function getModelCapability(id) {
+  return Object.prototype.hasOwnProperty.call(MODEL_CAPABILITIES, id) ? MODEL_CAPABILITIES[id] : undefined;
+}
+function describeKey(capability, key, source) {
+  const support = capability.params[key];
+  if (support === undefined) {
+    return [
+      {
+        kind: "unknown",
+        key,
+        message: `not in the CLI's capability data for ${capability.id}; not checked.`
+      }
+    ];
+  }
+  if (support.support === "unsupported") {
+    return [{ kind: "unsupported", key, source, message: support.reason }];
+  }
+  return [];
+}
+function describeInputKeys(capability, input) {
+  const disclosures = [];
+  for (const key of Object.keys(input)) {
+    if (key === "aspect_ratio")
+      continue;
+    disclosures.push(...describeKey(capability, key, "input"));
+  }
+  return disclosures;
+}
+function describeFlagKeys(capability, flags) {
+  return flags.aspectRatio === undefined ? [] : describeKey(capability, "aspect_ratio", "flag");
+}
+function describeDefaults(capability, input) {
+  return Object.entries(capability.params).flatMap(([key, support]) => {
+    if (support.support !== "supported" || support.default === undefined)
+      return [];
+    if (input[key] !== undefined)
+      return [];
+    return [
+      {
+        kind: "default",
+        key,
+        message: `${key} is not set; the model default ${support.default} applies. Set one explicit value for every call of a set.`
+      }
+    ];
+  });
+}
+function describeNotes(capability) {
+  return capability.notes.map((message) => ({ kind: "note", message }));
+}
+function describeConstraints(model, input, flags) {
+  const capability = getModelCapability(model);
+  if (capability === undefined) {
+    return [
+      {
+        kind: "note",
+        message: `The CLI has no capability data for ${model}; no constraints were checked.`
+      }
+    ];
+  }
+  return [
+    ...describeInputKeys(capability, input),
+    ...describeFlagKeys(capability, flags),
+    ...describeDefaults(capability, input),
+    ...describeNotes(capability)
+  ];
+}
+var FLUX_2_FLASH_MODEL = "fal-ai/flux-2/flash", FLUX_2_FLASH_EDIT_MODEL = "fal-ai/flux-2/flash/edit", FLASH_SOURCE = "https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/flux-2/flash (read 2026-10-24); no negative prompt: https://help.bfl.ai/articles/7734566352-does-flux-2-support-negative-prompting (read 2026-10-24)", EDIT_SOURCE = "https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/flux-2/flash/edit (read 2026-10-24); no negative prompt: https://help.bfl.ai/articles/7734566352-does-flux-2-support-negative-prompting (read 2026-10-24)", MODEL_CAPABILITIES;
+var init_model_capabilities = __esm(() => {
+  MODEL_CAPABILITIES = {
+    [FLUX_2_FLASH_MODEL]: {
+      id: FLUX_2_FLASH_MODEL,
+      name: "FLUX 2 Flash",
+      task: "text-to-image",
+      params: {
+        prompt: { support: "supported" },
+        seed: { support: "supported" },
+        output_format: { support: "supported" },
+        image_size: {
+          support: "supported",
+          default: "landscape_4_3",
+          note: "set one explicit value for every call of a set"
+        },
+        aspect_ratio: {
+          support: "unsupported",
+          reason: `FLUX 2 Flash sizes output with image_size. Pass --input '{"image_size":"landscape_4_3"}' instead.`
+        },
+        negative_prompt: {
+          support: "unsupported",
+          reason: "FLUX 2 Flash has no negative prompt; describe what you want in --prompt instead."
+        },
+        image_urls: {
+          support: "unsupported",
+          reason: "Text-to-image only; use --model fal-ai/flux-2/flash/edit with --input-image."
+        }
+      },
+      notes: [
+        "FLUX 2 Flash has no camera or perspective parameter; perspective comes only from the prompt.",
+        "Same-seed reproducibility is not documented by fal.",
+        "Returns PNG without an alpha channel by default."
+      ],
+      source: FLASH_SOURCE
+    },
+    [FLUX_2_FLASH_EDIT_MODEL]: {
+      id: FLUX_2_FLASH_EDIT_MODEL,
+      name: "FLUX 2 Flash (edit)",
+      task: "image-edit",
+      params: {
+        prompt: { support: "supported" },
+        seed: { support: "supported" },
+        image_urls: {
+          support: "supported",
+          note: "set by --input-image; the CLI sends one image"
+        },
+        image_size: {
+          support: "supported",
+          default: "square_hd",
+          note: "set one explicit value for every call of a set"
+        },
+        aspect_ratio: {
+          support: "unsupported",
+          reason: `FLUX 2 Flash (edit) sizes output with image_size. Pass --input '{"image_size":"square_hd"}' instead.`
+        },
+        negative_prompt: {
+          support: "unsupported",
+          reason: "FLUX 2 Flash has no negative prompt; describe what you want in --prompt instead."
+        }
+      },
+      notes: [
+        "FLUX 2 Flash has no camera or perspective parameter; perspective comes only from the prompt.",
+        "Not documented to carry a reference image's perspective over to new content; it may return a modified copy of the input.",
+        "Same-seed reproducibility is not documented by fal."
+      ],
+      source: EDIT_SOURCE
+    }
+  };
+});
+
 // src/commands/generate/image.ts
+var exports_image = {};
+__export(exports_image, {
+  planGenerateImage: () => planGenerateImage,
+  parseInputJson: () => parseInputJson,
+  generateImage: () => generateImage,
+  formatGenerateImagePlan: () => formatGenerateImagePlan,
+  GenerateImageError: () => GenerateImageError,
+  GENERATE_IMAGE_PLATFORMS: () => GENERATE_IMAGE_PLATFORMS,
+  FAL_API_KEY_MISSING_MESSAGE: () => FAL_API_KEY_MISSING_MESSAGE,
+  DEFAULT_GENERATE_IMAGE_PLATFORM: () => DEFAULT_GENERATE_IMAGE_PLATFORM
+});
 import { createHash } from "node:crypto";
 import { extname, resolve } from "node:path";
 function resolvePlatform(platform) {
@@ -2163,6 +2312,14 @@ function requireNonEmpty(value, message) {
   }
   return trimmed;
 }
+function inputImageContentType(path) {
+  const extension = extname(path).toLowerCase();
+  const contentType = INPUT_IMAGE_CONTENT_TYPES[extension];
+  if (contentType === undefined) {
+    throw new GenerateImageError(`Unsupported --input-image extension ${extension || "(none)"}. Use one of: ${Object.keys(INPUT_IMAGE_CONTENT_TYPES).join(", ")}.`);
+  }
+  return contentType;
+}
 function validateInputObject(input) {
   if ("sync_mode" in input && input.sync_mode !== undefined) {
     throw new GenerateImageError('--input must not contain "sync_mode": it returns data URIs that this command cannot download. Omit it.');
@@ -2176,6 +2333,9 @@ function validateInputObject(input) {
     }
   }
 }
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function parseInputJson(text) {
   let parsed;
   try {
@@ -2183,28 +2343,30 @@ function parseInputJson(text) {
   } catch {
     throw new GenerateImageError("--input must be valid JSON.");
   }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+  if (!isPlainObject(parsed)) {
     throw new GenerateImageError("--input must be a JSON object.");
   }
-  const input = parsed;
-  validateInputObject(input);
-  return input;
+  validateInputObject(parsed);
+  return parsed;
 }
-function buildInput(prompt, opts) {
-  if (opts.input !== undefined) {
-    if (typeof opts.input !== "object" || opts.input === null || Array.isArray(opts.input)) {
-      throw new GenerateImageError("--input must be a JSON object.");
-    }
-    validateInputObject(opts.input);
-  }
+function buildInput(prompt, opts, imageUrl) {
   return {
     prompt,
     ...opts.input ?? {},
     ...opts.aspectRatio !== undefined ? { aspect_ratio: opts.aspectRatio } : {},
     ...opts.outputFormat !== undefined ? { output_format: opts.outputFormat } : {},
-    ...opts.seed !== undefined ? { seed: opts.seed } : {}
+    ...opts.seed !== undefined ? { seed: opts.seed } : {},
+    ...imageUrl !== undefined ? { image_urls: [imageUrl] } : {}
   };
 }
+function validateInputOption(opts) {
+  if (opts.input === undefined)
+    return;
+  if (!isPlainObject(opts.input)) {
+    throw new GenerateImageError("--input must be a JSON object.");
+  }
+  validateInputObject(opts.input);
+}
 function requireImage(images, model) {
   const image = images[0];
   if (!image?.url) {
@@ -2266,6 +2428,7 @@ function buildManifest(args) {
     sdk: `@fal-ai/client@${args.sdkVersion}`,
     model: args.model,
     input: args.input,
+    inputImage: args.inputImage,
     requestId: args.requestId ?? null,
     seed: resolveSeed(args.resultSeed, args.requestedSeed),
     output: {
@@ -2278,21 +2441,118 @@ function buildManifest(args) {
     licensing: LICENSING
   };
 }
-async function generateImage(opts, deps) {
+function requireTaskPairing(capability, model, inputImage) {
+  if (capability.task === "image-edit" && inputImage === undefined) {
+    throw new GenerateImageError(`${model} edits an image; pass --input-image <path-or-url>.`);
+  }
+  if (capability.task === "text-to-image" && inputImage !== undefined) {
+    throw new GenerateImageError(`${model} does not take an input image; use --model ${FLUX_2_FLASH_EDIT_MODEL} with --input-image.`);
+  }
+}
+function requireAspectRatioSupport(capability, model, aspectRatio) {
+  if (aspectRatio === undefined)
+    return;
+  const support = capability.params.aspect_ratio;
+  if (support?.support !== "unsupported")
+    return;
+  throw new GenerateImageError(`--aspect-ratio is not supported by ${model}. ${support.reason}`);
+}
+function requireModelPairing(model, inputImage, aspectRatio) {
+  const capability = getModelCapability(model);
+  if (capability === undefined)
+    return;
+  requireTaskPairing(capability, model, inputImage);
+  requireAspectRatioSupport(capability, model, aspectRatio);
+}
+function resolveInputImageOption(opts) {
+  return opts.inputImage === undefined ? undefined : requireNonEmpty(opts.inputImage, "--input-image must not be empty.");
+}
+async function validateInputImage(deps, inputImage) {
+  if (inputImage === undefined)
+    return;
+  if (HTTP_URL_PATTERN.test(inputImage))
+    return { kind: "url", url: inputImage };
+  const localPath = resolve(inputImage);
+  const contentType = inputImageContentType(localPath);
+  const status = await deps.pathStatus(localPath);
+  if (status !== "file") {
+    throw new GenerateImageError(`--input-image is not a file: ${localPath}`);
+  }
+  return { kind: "file", path: localPath, contentType };
+}
+function planInputImageUrl(target) {
+  if (target === undefined)
+    return;
+  return target.kind === "url" ? target.url : `<fal storage URL for ${target.path}>`;
+}
+async function uploadInputImage(deps, target) {
+  if (target === undefined)
+    return { url: undefined, record: null };
+  if (target.kind === "url") {
+    return { url: target.url, record: { source: target.url, url: target.url } };
+  }
+  const url = await deps.uploadFile(target.path, target.contentType);
+  return { url, record: { source: target.path, url } };
+}
+async function planGenerateImage(opts, deps) {
   const platform = resolvePlatform(opts.platform);
   requireSupportedPlatform(platform);
-  requireFalKey(deps);
+  const model = requireNonEmpty(opts.model, "--model must not be empty.");
   const prompt = requireNonEmpty(opts.prompt, "--prompt must not be empty.");
   const outPath = resolve(requireNonEmpty(opts.out, "--out must not be empty."));
   requireSupportedExtension(outPath);
   if (opts.outputFormat !== undefined) {
     requireFormatMatchesExtension(outPath, opts.outputFormat);
   }
+  const inputImage = resolveInputImageOption(opts);
+  requireModelPairing(model, inputImage, opts.aspectRatio);
+  validateInputOption(opts);
+  const inputTarget = await validateInputImage(deps, inputImage);
   const manifestPath = `${outPath}.json`;
   await requireWritableOutput(deps, outPath, manifestPath, opts.force === true);
-  await deps.ensureParentDir(outPath);
-  const model = opts.model ?? DEFAULT_IMAGE_MODEL;
-  const input = buildInput(prompt, opts);
+  const input = buildInput(prompt, opts, planInputImageUrl(inputTarget));
+  return {
+    platform,
+    model,
+    outPath,
+    manifestPath,
+    input,
+    inputTarget,
+    disclosures: describeConstraints(model, input, { aspectRatio: opts.aspectRatio })
+  };
+}
+function disclosureFlag(key) {
+  return key === "aspect_ratio" ? "--aspect-ratio" : "--input";
+}
+function formatDisclosure(disclosure) {
+  if (disclosure.kind === "unsupported" || disclosure.kind === "unknown") {
+    return `- ${disclosure.kind}: ${disclosure.key} (${disclosureFlag(disclosure.key)}) — ${disclosure.message}`;
+  }
+  return `- ${disclosure.kind}: ${disclosure.message}`;
+}
+function formatInputImageLine(target) {
+  if (target === undefined)
+    return;
+  return target.kind === "url" ? `Input image ${target.url} (passed through)` : `Input image ${target.path} (would be uploaded to fal storage, 1-day lifetime)`;
+}
+function formatGenerateImagePlan(plan) {
+  const capability = getModelCapability(plan.model);
+  const lines = [
+    `Would generate ${plan.outPath}`,
+    `Manifest ${plan.manifestPath}`,
+    capability === undefined ? `Model ${plan.model} (no capability data)` : `Model ${plan.model} (${capability.name}, ${capability.task})`
+  ];
+  const inputLine = formatInputImageLine(plan.inputTarget);
+  if (inputLine !== undefined)
+    lines.push(inputLine);
+  lines.push("Request:", JSON.stringify(plan.input, null, 2), "Constraints:");
+  for (const disclosure of plan.disclosures)
+    lines.push(formatDisclosure(disclosure));
+  lines.push("No upload or fal call was made.");
+  return lines.join(`
+`);
+}
+async function generateAndSave(deps, model, input, outPath) {
   const result = await deps.falSubscribe(model, input);
   if (result.data.images.length > 1) {
     deps.warn(`⚠️ fal returned ${result.data.images.length} images; only the first is saved.`);
@@ -2300,25 +2560,46 @@ async function generateImage(opts, deps) {
   const image = requireImage(result.data.images, model);
   const bytes = await downloadImage(deps, result.requestId, image.url);
   await saveImage(deps, outPath, bytes, result.requestId, image.url);
-  const sha256 = createHash("sha256").update(bytes).digest("hex");
-  await deps.writeJson(manifestPath, buildManifest({
-    platform,
-    model,
-    input,
+  return {
+    image,
+    bytes,
+    sha256: createHash("sha256").update(bytes).digest("hex"),
     requestId: result.requestId,
-    resultSeed: result.data.seed,
+    seed: result.data.seed
+  };
+}
+async function generateImage(opts, deps) {
+  requireFalKey(deps);
+  const plan = await planGenerateImage(opts, deps);
+  for (const disclosure of plan.disclosures) {
+    if (disclosure.kind === "unsupported") {
+      deps.warn(`⚠️ ${disclosure.key}: ${disclosure.message}`);
+    }
+  }
+  await deps.ensureParentDir(plan.outPath);
+  const preparedInput = await uploadInputImage(deps, plan.inputTarget);
+  const input = preparedInput.url === undefined ? plan.input : { ...plan.input, image_urls: [preparedInput.url] };
+  const saved = await generateAndSave(deps, plan.model, input, plan.outPath);
+  await deps.writeJson(plan.manifestPath, buildManifest({
+    platform: plan.platform,
+    model: plan.model,
+    input,
+    inputImage: preparedInput.record,
+    requestId: saved.requestId,
+    resultSeed: saved.seed,
     requestedSeed: opts.seed,
-    outPath,
-    sha256,
-    contentType: image.content_type,
-    byteLength: bytes.byteLength,
+    outPath: plan.outPath,
+    sha256: saved.sha256,
+    contentType: saved.image.content_type,
+    byteLength: saved.bytes.byteLength,
     generatedAt: deps.now().toISOString(),
     sdkVersion: deps.sdkVersion
   }));
-  return { outPath, manifestPath, sha256 };
+  return { outPath: plan.outPath, manifestPath: plan.manifestPath, sha256: saved.sha256 };
 }
-var DEFAULT_IMAGE_MODEL = "fal-ai/flux-2/flash", GENERATE_IMAGE_PLATFORMS, DEFAULT_GENERATE_IMAGE_PLATFORM = "fal", GenerateImageError, LICENSING = "unverified", FAL_API_KEY_MISSING_MESSAGE = "FAL_API_KEY is not set. Set FAL_API_KEY in your environment to generate images with fal. (FAL_KEY_ID/FAL_KEY_SECRET are not supported by this command.)", EXTENSION_FORMATS, UNSUPPORTED_OUTPUT_EXTENSIONS, INPUT_DEDICATED_FLAGS;
+var GENERATE_IMAGE_PLATFORMS, DEFAULT_GENERATE_IMAGE_PLATFORM = "fal", GenerateImageError, LICENSING = "unverified", FAL_API_KEY_MISSING_MESSAGE = "FAL_API_KEY is not set. Set FAL_API_KEY in your environment to generate images with fal. (FAL_KEY_ID/FAL_KEY_SECRET are not supported by this command.)", EXTENSION_FORMATS, UNSUPPORTED_OUTPUT_EXTENSIONS, INPUT_DEDICATED_FLAGS, INPUT_IMAGE_CONTENT_TYPES, HTTP_URL_PATTERN;
 var init_image = __esm(() => {
+  init_model_capabilities();
   GENERATE_IMAGE_PLATFORMS = ["fal"];
   GenerateImageError = class GenerateImageError extends Error {
     constructor(message) {
@@ -2335,8 +2616,17 @@ var init_image = __esm(() => {
     prompt: "--prompt",
     seed: "--seed",
     output_format: "--output-format",
-    aspect_ratio: "--aspect-ratio"
+    aspect_ratio: "--aspect-ratio",
+    image_urls: "--input-image"
   };
+  INPUT_IMAGE_CONTENT_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif"
+  };
+  HTTP_URL_PATTERN = /^https?:\/\//i;
 });
 
 // src/commands/generate/local-image-common.ts
@@ -2350,6 +2640,13 @@ function sha256(bytes) {
 function errorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
+function median(values) {
+  const sorted = [...values].sort((a, b) => a - b);
+  const middle = Math.floor(sorted.length / 2);
+  if (sorted.length % 2 === 1)
+    return sorted[middle] ?? 0;
+  return Math.round(((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2);
+}
 function hasPngMagic(bytes) {
   if (bytes.length < PNG_MAGIC.length)
     return false;
@@ -2668,7 +2965,7 @@ var require_utils = __commonJS((exports) => {
   exports.isValidUrl = isValidUrl;
   exports.throttle = throttle;
   exports.isReact = isReact;
-  exports.isPlainObject = isPlainObject;
+  exports.isPlainObject = isPlainObject2;
   exports.sleep = sleep;
   function ensureEndpointIdFormat(id) {
     const parts = id.split("/");
@@ -2744,7 +3041,7 @@ var require_utils = __commonJS((exports) => {
     }
     return isRunningInReact;
   }
-  function isPlainObject(value) {
+  function isPlainObject2(value) {
     return !!value && Object.getPrototypeOf(value) === Object.prototype;
   }
   function sleep(ms) {
@@ -6495,7 +6792,7 @@ __export(exports_deps, {
   createFalRawSubscribe: () => createFalRawSubscribe,
   createDefaultGenerateImageDeps: () => createDefaultGenerateImageDeps
 });
-import { mkdir } from "node:fs/promises";
+import { mkdir, readFile } from "node:fs/promises";
 import { dirname as dirname2 } from "node:path";
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
@@ -6598,13 +6895,16 @@ function describeFalError(err) {
     return formatApiError(err);
   return err instanceof Error ? err.message : String(err);
 }
+function configureFal(env) {
+  const credentials = env.FAL_API_KEY;
+  if (!credentials) {
+    throw new GenerateImageError(FAL_API_KEY_MISSING_MESSAGE);
+  }
+  import_client.fal.config({ credentials });
+}
 function createFalRawSubscribe(env) {
   return async (model, input) => {
-    const credentials = env.FAL_API_KEY;
-    if (!credentials) {
-      throw new GenerateImageError(FAL_API_KEY_MISSING_MESSAGE);
-    }
-    import_client.fal.config({ credentials });
+    configureFal(env);
     try {
       return await import_client.fal.subscribe(model, {
         input,
@@ -6620,6 +6920,18 @@ function createFalSubscribe(env) {
   const subscribe = createFalRawSubscribe(env);
   return async (model, input) => validateFalResult(await subscribe(model, input));
 }
+function createFalUploadFile(env) {
+  return async (path, contentType) => {
+    configureFal(env);
+    try {
+      const bytes = await readFile(path);
+      const blob = new Blob([new Uint8Array(bytes)], { type: contentType });
+      return await import_client.fal.storage.upload(blob, { lifecycle: { expiresIn: "1d" } });
+    } catch (err) {
+      throw new GenerateImageError(`Failed to upload input image ${path}: ${describeFalError(err)}`);
+    }
+  };
+}
 async function ensureParentDir(path) {
   await mkdir(dirname2(path), { recursive: true });
 }
@@ -6642,6 +6954,7 @@ function createDefaultGenerateImageDeps() {
   return {
     env,
     falSubscribe: createFalSubscribe(env),
+    uploadFile: createFalUploadFile(env),
     fetchBytes,
     writeFile: writeFileBytes,
     writeJson: writeJsonFile,
@@ -8552,7 +8865,7 @@ var exports_slice_deps = {};
 __export(exports_slice_deps, {
   createDefaultSliceImageDeps: () => createDefaultSliceImageDeps
 });
-import { lstat, mkdir as mkdir2, readFile as readFile2, stat as stat3 } from "node:fs/promises";
+import { lstat, mkdir as mkdir2, readFile as readFile3, stat as stat3 } from "node:fs/promises";
 function decodePng(bytes) {
   const png = PNG.sync.read(Buffer.from(bytes));
   return { width: png.width, height: png.height, data: png.data };
@@ -8582,7 +8895,7 @@ async function statInput(path) {
 async function readJsonIfExists(path) {
   let text;
   try {
-    text = await readFile2(path, "utf8");
+    text = await readFile3(path, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
       return;
@@ -8619,7 +8932,7 @@ function createDefaultSliceImageDeps() {
   return {
     pathStatus,
     statInput,
-    readFile: readFile2,
+    readFile: readFile3,
     readJsonIfExists,
     decodePng,
     encodePng,
@@ -27379,7 +27692,7 @@ __export(exports_util, {
   jsonStringifyReplacer: () => jsonStringifyReplacer,
   joinValues: () => joinValues,
   issue: () => issue,
-  isPlainObject: () => isPlainObject,
+  isPlainObject: () => isPlainObject2,
   isObject: () => isObject,
   hexToUint8Array: () => hexToUint8Array,
   getSizableOrigin: () => getSizableOrigin,
@@ -27544,7 +27857,7 @@ function slugify(input) {
 function isObject(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
-function isPlainObject(o) {
+function isPlainObject2(o) {
   if (isObject(o) === false)
     return false;
   const ctor = o.constructor;
@@ -27561,7 +27874,7 @@ function isPlainObject(o) {
   return true;
 }
 function shallowClone(o) {
-  if (isPlainObject(o))
+  if (isPlainObject2(o))
     return { ...o };
   if (Array.isArray(o))
     return [...o];
@@ -27701,7 +28014,7 @@ function omit2(schema, mask) {
   return clone(schema, def);
 }
 function extend(schema, shape) {
-  if (!isPlainObject(shape)) {
+  if (!isPlainObject2(shape)) {
     throw new Error("Invalid input to extend: expected a plain object");
   }
   const checks = schema._zod.def.checks;
@@ -27724,7 +28037,7 @@ function extend(schema, shape) {
   return clone(schema, def);
 }
 function safeExtend(schema, shape) {
-  if (!isPlainObject(shape)) {
+  if (!isPlainObject2(shape)) {
     throw new Error("Invalid input to safeExtend: expected a plain object");
   }
   const def = mergeDefs(schema._zod.def, {
@@ -29207,7 +29520,7 @@ function mergeValues(a, b) {
   if (a instanceof Date && b instanceof Date && +a === +b) {
     return { valid: true, data: a };
   }
-  if (isPlainObject(a) && isPlainObject(b)) {
+  if (isPlainObject2(a) && isPlainObject2(b)) {
     const bKeys = Object.keys(b);
     const sharedKeys = Object.keys(a).filter((key) => bKeys.indexOf(key) !== -1);
     const newObj = { ...a, ...b };
@@ -30464,7 +30777,7 @@ var init_schemas = __esm(() => {
     $ZodType.init(inst, def);
     inst._zod.parse = (payload, ctx) => {
       const input = payload.value;
-      if (!isPlainObject(input)) {
+      if (!isPlainObject2(input)) {
         payload.issues.push({
           expected: "record",
           code: "invalid_type",
@@ -71424,7 +71737,7 @@ var require_filesystem = __commonJS((exports, module) => {
     fs6.close(fd, () => {});
     return buffer.subarray(0, bytesRead);
   };
-  var readFile6 = (path2) => new Promise((resolve6, reject) => {
+  var readFile7 = (path2) => new Promise((resolve6, reject) => {
     fs6.open(path2, "r", (err, fd) => {
       if (err) {
         reject(err);
@@ -71441,7 +71754,7 @@ var require_filesystem = __commonJS((exports, module) => {
     LDD_PATH,
     SELF_PATH,
     readFileSync: readFileSync12,
-    readFile: readFile6
+    readFile: readFile7
   };
 });
 
@@ -71483,7 +71796,7 @@ var require_elf = __commonJS((exports, module) => {
 var require_detect_libc = __commonJS((exports, module) => {
   var childProcess = __require("child_process");
   var { isLinux, getReport } = require_process();
-  var { LDD_PATH, SELF_PATH, readFile: readFile6, readFileSync: readFileSync12 } = require_filesystem();
+  var { LDD_PATH, SELF_PATH, readFile: readFile7, readFileSync: readFileSync12 } = require_filesystem();
   var { interpreterPath } = require_elf();
   var cachedFamilyInterpreter;
   var cachedFamilyFilesystem;
@@ -71563,7 +71876,7 @@ var require_detect_libc = __commonJS((exports, module) => {
     }
     cachedFamilyFilesystem = null;
     try {
-      const lddContent = await readFile6(LDD_PATH);
+      const lddContent = await readFile7(LDD_PATH);
       cachedFamilyFilesystem = getFamilyFromLddContent(lddContent);
     } catch (e) {}
     return cachedFamilyFilesystem;
@@ -71585,7 +71898,7 @@ var require_detect_libc = __commonJS((exports, module) => {
     }
     cachedFamilyInterpreter = null;
     try {
-      const selfContent = await readFile6(SELF_PATH);
+      const selfContent = await readFile7(SELF_PATH);
       const path2 = interpreterPath(selfContent);
       cachedFamilyInterpreter = familyFromInterpreterPath(path2);
     } catch (e) {}
@@ -71645,7 +71958,7 @@ var require_detect_libc = __commonJS((exports, module) => {
     }
     cachedVersionFilesystem = null;
     try {
-      const lddContent = await readFile6(LDD_PATH);
+      const lddContent = await readFile7(LDD_PATH);
       const versionMatch = lddContent.match(RE_GLIBC_VERSION);
       if (versionMatch) {
         cachedVersionFilesystem = versionMatch[1];
@@ -82140,7 +82453,7 @@ var require_loadImage = __commonJS((exports, module) => {
   var fs8 = __require("fs");
   var fetch2 = global.fetch || require_lib3();
   var isURL = require_is_url();
-  var readFile6 = util.promisify(fs8.readFile);
+  var readFile7 = util.promisify(fs8.readFile);
   module.exports = async (image) => {
     let data = image;
     if (typeof image === "undefined") {
@@ -82153,7 +82466,7 @@ var require_loadImage = __commonJS((exports, module) => {
       } else if (/data:image\/([a-zA-Z]*);base64,([^"]*)/.test(image)) {
         data = Buffer.from(image.split(",")[1], "base64");
       } else {
-        data = await readFile6(image);
+        data = await readFile7(image);
       }
     } else if (Buffer.isBuffer(image)) {
       data = image;
@@ -82753,9 +83066,9 @@ function merge5(...objs) {
     }
     const targetKey = caseless && typeof key === "string" && findKey(result3, key) || key;
     const existing = hasOwnProperty(result3, targetKey) ? result3[targetKey] : undefined;
-    if (isPlainObject2(existing) && isPlainObject2(val)) {
+    if (isPlainObject3(existing) && isPlainObject3(val)) {
       result3[targetKey] = merge5(existing, val);
-    } else if (isPlainObject2(val)) {
+    } else if (isPlainObject3(val)) {
       result3[targetKey] = merge5({}, val);
     } else if (isArray2(val)) {
       result3[targetKey] = val.slice();
@@ -82858,7 +83171,7 @@ var toString2, getPrototypeOf, iterator, toStringTag, hasOwnProperty, isUnsafeOb
 }, kindOf, kindOfTest = (type) => {
   type = type.toLowerCase();
   return (thing) => kindOf(thing) === type;
-}, typeOfTest = (type) => (thing) => typeof thing === type, isArray2, isUndefined2, isArrayBuffer, isString2, isFunction2, isNumber2, isObject3 = (thing) => thing !== null && typeof thing === "object", isBoolean = (thing) => thing === true || thing === false, isPlainObject2 = (val) => {
+}, typeOfTest = (type) => (thing) => typeof thing === type, isArray2, isUndefined2, isArrayBuffer, isString2, isFunction2, isNumber2, isObject3 = (thing) => thing !== null && typeof thing === "object", isBoolean = (thing) => thing === true || thing === false, isPlainObject3 = (val) => {
   if (!isObject3(val)) {
     return false;
   }
@@ -83134,7 +83447,7 @@ var init_utils = __esm(() => {
     isNumber: isNumber2,
     isBoolean,
     isObject: isObject3,
-    isPlainObject: isPlainObject2,
+    isPlainObject: isPlainObject3,
     isEmptyObject,
     isReadableStream,
     isRequest,
@@ -106274,7 +106587,7 @@ var exports_parse_pdf = {};
 __export(exports_parse_pdf, {
   parsePdf: () => parsePdf
 });
-import { access, readFile as readFile6, writeFile as writeFile7, mkdir as mkdir7, appendFile } from "node:fs/promises";
+import { access, readFile as readFile7, writeFile as writeFile7, mkdir as mkdir7, appendFile } from "node:fs/promises";
 import { resolve as resolve6 } from "node:path";
 function isUrl(input) {
   return input.startsWith("http://") || input.startsWith("https://");
@@ -106284,9 +106597,9 @@ function createDefaultDeps6() {
     fs: {
       access: (p) => access(p),
       mkdir: (p, opts) => mkdir7(p, opts).then(() => {}),
-      readFile: (p, enc) => readFile6(p, { encoding: enc }).then((b) => b.toString()),
+      readFile: (p, enc) => readFile7(p, { encoding: enc }).then((b) => b.toString()),
       appendFile: (p, content) => appendFile(p, content),
-      readFileAsBuffer: (p) => readFile6(p),
+      readFileAsBuffer: (p) => readFile7(p),
       writeFile: (p, content, enc) => writeFile7(p, content, enc)
     },
     parser: {
@@ -107472,9 +107785,11 @@ function getEntryPointToArchitectHandoffTemplate(query) {
   const entryPoint = query.fromRole;
   return `The automatically injected \`<user-message>\` is the authoritative request. Add only concise context that the Architect needs to design within the existing repository and team scope.
 
+Use this before any backend contract, API, or schema/persistence change.
+
 Provide the request, relevant constraints, and the files or product surfaces that need inspection. Ask for one evidence-backed design focused on ${getArchitectFocus()}.
 
-After completing the design, hand it back to \`${entryPoint}\` with the normal handoff command. Stop after the successful handoff; do not implement the design or delegate further work.
+After completing the design, the \`architect\` must hand it back to \`${entryPoint}\` with the normal handoff command, then stop; it must not implement the design or delegate further work.
 
 \`\`\`bash
 ${handoffCommand({
@@ -107914,7 +108229,7 @@ function formatProofOfPrinciples() {
 var GAME_ASSET_RULES;
 var init_game_asset_designer_workflow = __esm(() => {
   GAME_ASSET_RULES = [
-    "Generate only with `chatroom generate-image --platform=fal`, using the CLI default model `fal-ai/flux-2/flash` unless the brief names one.",
+    "Generate only with `chatroom generate-image --platform=fal --model <Model>`, where <Model> is the brief's Model: `fal-ai/flux-2/flash` (FLUX 2 Flash), or `fal-ai/flux-2/flash/edit` with --input-image for reference edits.",
     "Process images only with `chatroom slice-image` and `chatroom remove-image-background`; no other tool, script, or remote service.",
     "A sheet is at most the brief's `Sheet grid` (default 2x2); a larger grid needs a user request quoted in the brief.",
     "Names come from looking at each tile, never from cell order or prompt order.",
@@ -107928,14 +108243,15 @@ var init_game_asset_designer_workflow = __esm(() => {
     "Never switch generators.",
     "Describe generated output as production-ready only when every checklist item for it passes with `measured` or `inspected` evidence.",
     "Commit only when the brief names the paths and the commit message.",
-    "Generate only when the brief names an output location and allowed tools."
+    "Generate only when the brief names an output location and allowed tools.",
+    "Before the first real call of each command shape (sheet, per-asset, or reference edit), run the same command with --dry-run and apply every constraint it prints; take model-specific constraints only from the dry run, never from memory."
   ];
 });
 
 // ../../services/backend/prompts/teams/game-asset-designer-handoff-templates.ts
 function getEntryPointToGameAssetDesignerHandoffTemplate(query) {
   const entryPoint = query.fromRole;
-  return `Instructions (not part of the message): Pass the asset request as a brief the designer can act on without guessing. Provide every field below; write \`Not specified.\` for a field you cannot fill and the designer will ask or apply a stated default. Give each asset a stable ID (\`A01\`, \`A02\`…). Use \`spec only\` only when you want a specification with no files; the default is \`spec and generate\`. The \`## Allowed tools\` value is fixed: \`chatroom generate-image --platform=fal (default model), chatroom slice-image, chatroom remove-image-background\`. Do not name any other generator.
+  return `Instructions (not part of the message): Pass the asset request as a brief the designer can act on without guessing. Provide every field below; write \`Not specified.\` for a field you cannot fill and the designer will ask or apply a stated default. Give each asset a stable ID (\`A01\`, \`A02\`…). Use \`spec only\` only when you want a specification with no files; the default is \`spec and generate\`. The \`## Allowed tools\` value is fixed: \`chatroom generate-image --platform=fal --model <Model> (dry run first), chatroom slice-image, chatroom remove-image-background\`. Do not name any other generator.
 
 ## Asset request
 <one to three sentences: what the assets are for and the user-visible goal>
@@ -107952,14 +108268,17 @@ function getEntryPointToGameAssetDesignerHandoffTemplate(query) {
 ## Style reference
 <repository paths, URLs, or a written style sheet; or \`Not specified.\`>
 
+## Perspective
+<one camera perspective shared by every asset in the set, for example \`orthographic front view\`, \`orthographic isometric\`, \`dimetric 2:1\`, or \`side view\`; optionally \`reference: <repository path>\` of an existing asset to match (requires \`## Model\` = \`fal-ai/flux-2/flash/edit\`); a reference makes every asset an individual edit, with no sheets; \`Not Applicable.\` for 3D models and audio; or \`Not specified.\`>
+
 ## Model
-<the CLI default \`fal-ai/flux-2/flash\`>
+<\`fal-ai/flux-2/flash\` (FLUX 2 Flash), passed as --model; \`fal-ai/flux-2/flash/edit\` only when \`## Perspective\` names a reference asset>
 
 ## Model parameters
-<a JSON object as text passed to \`generate-image --input\`; \`Not specified.\` if none>
+<a JSON object as text passed to \`generate-image --input\`; one object for every call of a set; its keys must pass the model's --dry-run check; \`Not specified.\` if none>
 
 ## Spec consumer
-<who integrates these assets from the spec: \`builder\` (application code) or \`user\`; asset files themselves are generated only by \`game-asset-designer\`>
+<who integrates these assets from the spec: \`builder\` (application logic outside the allowed edit paths) or \`user\`; asset files themselves are generated only by \`game-asset-designer\`>
 
 ## Existing assets
 <repository paths the designer must reuse or must not overwrite; or \`Not specified.\`>
@@ -107968,7 +108287,7 @@ function getEntryPointToGameAssetDesignerHandoffTemplate(query) {
 <\`spec and generate\` (default when you name an output location and allowed tools) or \`spec only\`>
 
 ## Allowed tools
-\`chatroom generate-image --platform=fal (default model), chatroom slice-image, chatroom remove-image-background\`
+\`chatroom generate-image --platform=fal --model <Model> (dry run first), chatroom slice-image, chatroom remove-image-background\`
 
 ## Allowed edit paths
 <repository-relative paths the designer may edit; \`None.\` for none>
@@ -107997,7 +108316,7 @@ Instructions after the body (not part of the message): the planner may append ex
 - assets must meet engine import conventions or budgets before a builder integrates them;
 - the user asks for an asset spec, style sheet, or asset audit.
 
-Skip it for code-only work and for a trivial asset rename. Non-game UI icons and illustrations also go to this role; they are not sent to \`uiux-engineer\`.
+Skip it for code-only work. Non-game UI icons and illustrations also go to this role; they are not sent to \`uiux-engineer\`.
 
 \`\`\`bash
 ${handoffCommand({
@@ -108028,7 +108347,7 @@ ${PROOF_OF_PRINCIPLES_REPORT}
 <each assumption you made and why; each deviation from the planner's target or budgets; or \`None.\`>
 
 ## Asset manifest
-<one entry per asset, keyed by the planner's stable ID (\`A01\`…): name, category, file format, path (or \`Specified only.\`), dimensions/units/scale, pivot, naming, LOD list with triangle budgets, texture set with resolution, color space and channel packing, atlas/pixel grid/frame data, audio format and loudness target, import settings, dependencies and variants; for each budget, the acceptance check (exact command and expected value); for each generated file, the generator command line (\`chatroom generate-image\` with its \`--platform\`, \`--model\`, and \`--seed\` values), the sheet and tile manifests, and the isolated asset manifest path>
+<one entry per asset, keyed by the planner's stable ID (\`A01\`…): name, category, file format, path (or \`Specified only.\`), dimensions/units/scale, pivot, naming, LOD list with triangle budgets, texture set with resolution, color space and channel packing, atlas/pixel grid/frame data, audio format and loudness target, import settings, dependencies and variants; for each budget, the acceptance check (exact command and expected value); for each generated file, the generator command line (\`chatroom generate-image\` with its \`--platform\`, \`--model\`, \`--seed\`, \`--input\`, and \`--input-image\` values), the sheet and tile manifests, and the isolated asset manifest path>
 
 ## Quality checklist results
 <per asset: each applicable checklist item as \`pass\`, \`fail\`, \`n/a\`, or \`not checked\`, with its evidence label and, for \`measured\`, the command and value; write exactly \`None failed.\` after the list if no item failed>
@@ -108058,7 +108377,7 @@ Write exactly \`None.\` if no sheet was used.
 <every property you could not measure or inspect; write exactly \`None.\` if none>
 
 ## Recommended next step
-<exactly one target: \`game-asset-designer\` (re-run with the listed asset IDs), \`builder\` (integrate, or apply the listed import settings), \`uiux-engineer\` (layout, component, or styling changes only, never asset files), or \`planner\` (decision needed on an open question); then the affected asset IDs>
+<exactly one target: \`game-asset-designer\` (re-run with the listed asset IDs), \`builder\` (application logic outside the allowed edit paths), \`uiux-engineer\` (layout, component, or styling changes only, never asset files), or \`planner\` (decision needed on an open question); then the affected asset IDs>
 
 Instructions after the body (not part of the message): run the normal handoff command to \`${entryPoint}\` with the complete body above, then stop.
 
@@ -108129,11 +108448,11 @@ var init_planner_architect_chat = __esm(() => {
 function getPlannerBuilderCodeBody() {
   return `${getDelegationBriefIntro()}
 
-**Before you delegate:** if this slice introduces anything not yet grounded in the repository (a new library, API, external platform behavior, or an unresolved design choice), hand off to \`researcher\` first and delegate only after its brief returns. Skip this for small, well-understood edits. The \`researcher\` handoff template defines the criteria.
+**Before you delegate:** if this slice introduces anything not yet grounded in the repository (a new library, API, external platform behavior, or an unresolved choice that depends on missing facts), hand off to \`researcher\` first and delegate only after its brief returns. Skip this when the \`researcher\` template's skip condition applies. The \`researcher\` handoff template defines the criteria.
 
 **Bug fixes:** if this slice fixes a reported bug, delegate only after a \`triage\` report for that bug has returned, and build the brief from its root cause and proposed fix. The \`triage\` handoff template defines the investigation.
 
-**Division of labor:** You (planner) own architecture and API shape. The UI/UX engineer owns UI/UX design. Include its target markup, classes, and styles in UI implementation briefs; the builder implements the components.
+**Division of labor:** For backend contract, API, or schema/persistence changes, the architect designs first and you delegate only after its design returns. You (planner) own slicing and sequencing of builder work. The UI/UX engineer owns UI/UX design. Include its target markup, classes, styles, and screen and flow drawings in UI implementation briefs; the builder implements the components.
 
 **Detail bar:** Specify down to **every file** the builder will create or modify (full repo paths). Include code snippets — types, signatures, stubs, or target implementations — until a competent builder **cannot misinterpret** what to write. Vague layers ("update the backend", "fix the component") are not acceptable.
 
@@ -108236,7 +108555,7 @@ function getEntryPointToResearcherHandoffTemplate(query) {
 Research before delegating when the slice introduces something not already grounded in this repository:
 - a new library, API, external service, platform behavior, or version-sensitive dependency;
 - an unfamiliar subsystem;
-- a change with several plausible designs;
+- a choice between several plausible approaches that depends on facts not yet in the repository (the \`architect\` still owns backend contract, API, and schema/persistence design);
 - any ambiguity the user has not resolved.
 
 Skip research when the change is a small, well-understood edit in code you have already inspected.
@@ -108323,7 +108642,7 @@ Review before delivery for code-producing work:
 - the user asks for a code review;
 - a change is large, risky, or touches security-sensitive or shared code.
 
-Skip review for a trivial edit that has already been verified.
+Skip review only for an edit of a few lines in one file that the builder already verified with a test or command.
 
 After completing the review, the reviewer must return its issue report to \`${entryPoint}\` with the normal handoff command.
 
@@ -108385,6 +108704,8 @@ function getEntryPointToTriageHandoffTemplate(query) {
   const entryPoint = query.fromRole;
   return `The automatically injected \`<user-message>\` is the authoritative request. Pass the reported bug, observed and expected behavior, reproduction details and commands, relevant constraints, and the files or symbols already suspected. Ask triage to investigate and report only. Triage may inspect code and attempt a focused automated regression test as evidence, but must not edit implementation files or implement a fix.
 
+Use this for every reported bug (something broken or behaving differently than expected) before any fix is implemented.
+
 After completing the investigation, triage must return the evidence-backed report to \`${entryPoint}\` with the normal handoff command.
 
 \`\`\`bash
@@ -108451,11 +108772,12 @@ var init_planner_triage_chat = __esm(() => {
 
 // ../../services/backend/prompts/teams/uiux-engineer-handoff-templates.ts
 function getUiuxEngineerFocus() {
-  return "complete user flows, loading/empty/error/success states, component ownership, theme tokens and layout, responsive details, and UI tests";
+  return "complete user flows, screen and flow drawings, loading/empty/error/success states, component ownership, theme tokens and layout, responsive details, and UI tests";
 }
 function getUiuxEngineerRequirements() {
   return `
 - Specify complete user flows with explicit loading, empty, error, success, disabled, and retry states where applicable.
+- For any user-facing workflow, draw each affected screen as an ASCII wireframe and each flow as a Mermaid flowchart, using the "Screens, Flows, and Layouts" section. Each screen drawing labels every button, input, and link with its exact text and the repository component it uses; each flow drawing shows the loading, empty, error, success, disabled, and retry transitions that apply.
 - Define component hierarchy and ownership, props/state/events, data boundaries, and interaction behavior.
 - Choose concrete existing ShadCN components with the Base UI backend and lucide-react/react-icons conventions; do not write "use an appropriate component."
 - Specify Tailwind utility classes or semantic theme-token classes for layout, spacing, sizing, typography, states, responsive behavior, and dark mode.
@@ -108470,7 +108792,7 @@ function getEntryPointToUiuxEngineerHandoffTemplate(query) {
 
 Provide the request, relevant constraints, and the files or product surfaces that need inspection. Ask for one evidence-backed design focused on ${getUiuxEngineerFocus()}.
 
-After completing the design, hand it back to \`${entryPoint}\` with the normal handoff command. Stop after the successful handoff; do not implement the design or delegate further work.
+After completing the design, the \`uiux-engineer\` must hand it back to \`${entryPoint}\` with the normal handoff command, then stop; it must not implement the design or delegate further work.
 
 \`\`\`bash
 ${handoffCommand({
@@ -108498,6 +108820,24 @@ function getUiuxEngineerToEntryPointHandoffTemplate(query) {
 - Name concrete repository paths, existing components/tokens, props/state/events, data boundaries, acceptance criteria, risks, and verification steps.
 ${getUiuxEngineerRequirements()}
 
+## Screens, Flows, and Layouts
+<required for a user-facing workflow; write exactly \`Not Applicable.\` for a non-visual change>
+
+### Flow: <flow name>
+\`\`\`mermaid
+flowchart TD
+  <one node per screen or state; each edge labelled with the user action or system event that triggers it; include the loading, empty, error, success, disabled, and retry states that apply>
+\`\`\`
+
+### Screen: <screen name> (\`<route or entry point>\`)
+\`\`\`text
+<ASCII wireframe: the layout regions, headings, and every button, input, and link labelled with its exact text, with the repository component in brackets, for example [Button variant="destructive"]. Show the empty, loading, and error variants as separate drawings if they change the layout.>
+\`\`\`
+- States: <loading, empty, error, success, disabled, retry — which apply and how each changes the layout>
+- Responsive: <breakpoint behavior, one line per breakpoint that changes the layout>
+
+<repeat one ### Flow block per flow and one ### Screen block per screen; do not collapse several screens into one drawing>
+
 ## Force Multipliers
 <name the existing components, patterns, tokens, utilities, and platform conventions to reuse, and state why each reduces implementation risk or duplication>
 - Keep the design within the repository's established source-of-truth boundaries and avoid introducing a new registry or abstraction without evidence.
@@ -109928,7 +110268,7 @@ var init_architect3 = __esm(() => {
   init_sections();
   ARCHITECT_GUIDANCE = `## Architect Operating Model
 
-You are the architect responsible for careful coding and system design. You are advisory only: do not implement code, edit files, or act as the builder.
+You are the architect responsible for system design and code-level implementation plans. You are advisory only: do not implement code, edit files, or act as the builder.
 
 ${"{SESSION_CONTINUITY}"}
 
@@ -109962,7 +110302,7 @@ var init_game_asset_designer2 = __esm(() => {
   init_sections();
   GAME_ASSET_DESIGNER_GUIDANCE = `## Game Asset Designer Operating Model
 
-You specify production-quality game assets and generate them only with \`chatroom generate-image --platform=fal\` when the planner's request allows it. You are not the builder or planner; do not implement application logic outside the asset-integration paths the brief allows. Your delivery report uses Proof of Principles and Proof of Completion.
+You specify and generate production-quality game and UI assets (generation is the default unless the brief says \`spec only\`), using \`chatroom generate-image --platform=fal\`. You are not the builder or planner; do not implement application logic outside the asset-integration paths the brief allows. Your delivery report uses Proof of Principles and Proof of Completion.
 
 ${"{SESSION_CONTINUITY}"}
 
@@ -109980,7 +110320,7 @@ P1 Recover the brief. IF engine, tier, style, or budgets are missing and the rep
 P2 Inspect assets, names, folders, engine config; cite paths.
 P3 Classify each asset; one manifest entry per ID (\`A01\`…).
 P4 IF \`Deliverable mode\` = \`spec only\` OR \`Output location\`/\`Allowed tools\` missing/ambiguous THEN no files, deliver \`Specified only.\`, GOTO P10.
-P5 Count N. IF N=1 or styles differ THEN per-asset \`generate-image\`, GOTO P8. ELSE use ceil(N / (C×R)) sheets of ≤(C×R) items per \`Sheet grid\` (2x2 default). Prompt: one item per cell, CxR grid, no lines/borders/frames/duplicates. Generate \`generate-image --platform=fal --prompt "<prompt>" --out <Output location>/_work/<sheet>.png\`.
+P5 Count N. IF N=1 or styles differ THEN per-asset \`generate-image\`, GOTO P8. ELSE use ceil(N / (C×R)) sheets of ≤(C×R) items per \`Sheet grid\` (2x2 default). Prompt: one item per cell, CxR grid, no lines/borders/frames/duplicates. Generate \`generate-image --platform=fal --model <Model> --prompt "<prompt>" --out <Output location>/_work/<sheet>.png\`.
 P6 \`chatroom slice-image --in <sheet> --out-dir <Output location>/_work/tiles --cols C --rows R\`. IF refused regenerate once; IF still refused one \`generate-image\` per asset (P5).
 P7 View each tile. IF any tile has 0/2+ items, a cut item, or count differs from the brief's requested count (extra cells OK) THEN regenerate once; IF still bad THEN one \`generate-image\` per asset (P5). Name from sight.
 P8 IF \`remove-image-background --help\` succeeds THEN run \`remove-image-background --in-dir <tiles> --out-dir <Output location> --map <stem>=<name>,... --trim\` (single: \`--in <image> --out <Output location>/<name>.png --trim\`); view results. IF warnings/halo THEN rerun with \`--tolerance\`/\`--force\` max twice, ELSE accept. ELSE rerun \`slice-image --names\`; record trimming not delivered as a failed item/open question.
@@ -110019,11 +110359,20 @@ P11 Hand off to \`{ENTRY_POINT_ROLE}\`, then stop.
 - Animation: uniform frame size per clip, frame count, frame rate, loop flag, and pivot per clip.
 - Atlas: padding of at least the engine default (Unity default 4 px), atlas size within the platform max, filter mode Point for pixel art and no mip maps.
 - Export PNG (lossless with alpha); name states size and frame count where relevant.
+- Camera perspective matches the perspective chosen for the set (the brief's \`Perspective\`, or the one recorded under assumptions) and every other asset in the set (compare them side by side); \`n/a\` for a single asset.
 
 **Audio**
 - Loudness measured against the platform target stated in the request (for example console -24 LUFS, mobile -18 LUFS, true peak at or below -1 dBTP); no clipping. Measure with a tool: \`ffmpeg -i <file> -af ebur128=peak=true -f null -\` for integrated loudness and true peak; \`ffprobe <file>\` for sample rate, bit depth and channels; for glTF, \`gltf-transform inspect <file>\` (quote the command's actual output). Cite the platform source. If the request does not state the target, mark the loudness target \`unverified\` and name the source. Mobile targets vary (-18 vs -16 LUFS).
 - Sample rate, bit depth, channel count, loop points, and format stated; short noisy SFX use PCM or ADPCM, long audio uses compressed or streamed formats, per the engine's guidance.
 
+### Perspective consistency (generated 2D sets)
+Assets used together must share one camera perspective. The model's constraints (unsupported parameters, size defaults, what it does not guarantee) come only from \`generate-image --dry-run\` (R16); apply them, and never add a parameter the dry run reports as unsupported.
+- Repeat the perspective term from the brief's \`Perspective\` word for word in every prompt of the set (never the \`reference:\` path), and add the same flattening terms to every prompt: \`flat 2D game asset, orthographic, centered, plain background, even lighting\`. Suggested perspective terms (\`unverified\`): side view, front view, orthographic top-down, orthographic isometric, dimetric 2:1, three-quarter view. If the field names only a reference, describe that reference's view in words and record the description under assumptions. If \`Perspective\` is \`Not specified.\`, pick one, record it under assumptions, and use it for the whole set. If the \`Style reference\` asks for a lighting style these terms contradict (for example dramatic lighting), keep the perspective term and drop only the conflicting flattening term.
+- Use one \`--input\` JSON (from \`Model parameters\`) on every call of the set; if the dry run reports a size parameter as defaulted, set it once in that JSON and reuse it. Add \`--input '<JSON>'\` and the seed to every P5 command.
+- Use one shared \`--seed\` for the first call of each item or sheet. For every regeneration (P6, P7, or a perspective mismatch), use a new seed and record it (P9). A shared seed does not keep perspective across different prompts.
+- Pass \`--input-image <path>\` with \`--model fal-ai/flux-2/flash/edit\` only when the brief's \`Model\` is \`fal-ai/flux-2/flash/edit\` and \`Perspective\` names a reference path. In this mode generate every asset individually (the P5 per-asset path, one \`--input-image\` per asset); never use a sheet.
+- Inspect the set side by side. A mismatched item is regenerated individually (the P5 per-asset path, with a new seed), at most twice per item, separately from the sheet regenerations of P6 and P7. If it still differs, mark the perspective checklist item \`fail\` with \`inspected\` evidence.
+
 ### Scope boundary
 You may specify, name, organize, generate, validate, and integrate assets within the paths the brief allows. You must not claim fidelity you did not establish. If you cannot open or measure a file, write \`unverified\`. Do not present alternative art directions beyond what the request needs; recommend one.
 
@@ -110128,17 +110477,18 @@ ${getInterRoleHandoffRule()}
 
 1. Recover the authoritative user request and relevant chatroom history before designing. Inspect existing UI patterns, components, tokens, interaction conventions, and nearby tests that constrain the experience.
 2. Treat the injected \`<handoff-templates>\` UI/UX Engineer Design Handoff Brief as authoritative. Complete every section in its exact order, using \`Not Applicable.\` only for a genuinely inapplicable section and never as filler.
-3. Produce exactly one recommended, evidence-backed interface and experience design. Do not present alternatives or generic UX advice. Include concrete repository paths, complete user flows, and explicit loading, empty, error, success states (with loading, empty, error, and success states covered), plus disabled and retry states where applicable.
-4. Specify exact keyboard shortcuts, focus order, keyboard navigation, focus restoration, accessible semantics and labels, component hierarchy and ownership, props/state/events, data boundaries, and interaction behavior.
-5. Choose concrete ShadCN components using the Base UI backend and existing icon conventions. Specify exact Tailwind utility or semantic theme-token classes for layout, spacing, sizing, typography, states, responsive behavior, and dark mode; keep the styling theme-aware and make state ownership explicit. Also specify responsive breakpoints, visual feedback, destructive-action safeguards, and the UI/integration/accessibility test plan.
-6. Keep the proposal within the user's request and the repository's established patterns. Do not expand scope, spawn subagents, implement the design, edit files, or act as the builder. You do not generate asset files: any icon or illustration is specified by \`game-asset-designer\` and generated by \`game-asset-designer\`.
-7. Hand the complete design brief to \`{ENTRY_POINT_ROLE}\` with the normal command, then stop:
+3. Produce exactly one recommended, evidence-backed interface and experience design. Do not present alternatives or generic UX advice. Include concrete repository paths, complete user flows, and explicit loading, empty, error, and success states, plus disabled and retry states where applicable.
+4. For any user-facing workflow, draw each affected screen as an ASCII wireframe (every button and state labelled) and each flow as a Mermaid flowchart in the handback. Write \`Not Applicable.\` for the drawings section only when the change is non-visual.
+5. Specify component hierarchy and ownership, props/state/events, data boundaries, and interaction behavior. Do not propose or require web accessibility implementation work unless the user explicitly requests it.
+6. Choose concrete ShadCN components using the Base UI backend and existing icon conventions. Specify exact Tailwind utility or semantic theme-token classes for layout, spacing, sizing, typography, states, responsive behavior, and dark mode; keep the styling theme-aware and make state ownership explicit. Also specify responsive breakpoints, visual feedback, destructive-action safeguards, and the UI/integration test plan.
+7. Keep the proposal within the user's request and the repository's established patterns. Do not expand scope, spawn subagents, implement the design, edit files, or act as the builder. You do not generate asset files: any icon or illustration is specified by \`game-asset-designer\` and generated by \`game-asset-designer\`.
+8. Hand the complete design brief to \`{ENTRY_POINT_ROLE}\` with the normal command, then stop:
 
 \`\`\`bash
 chatroom handoff --chatroom-id="<chatroom-id>" --role="uiux-engineer" --next-role="{ENTRY_POINT_ROLE}"
 \`\`\`
 
-The handoff must contain every required brief section, repository evidence, chosen flow, exact component/prop/state details, explicit states, accessibility details, ownership decisions, concrete classes/tokens, risks, acceptance criteria, tests, and implementation sequence \`{ENTRY_POINT_ROLE}\` needs to coordinate implementation. It must not contain implementation edits or alternative designs.`;
+The handoff must contain every required brief section, repository evidence, chosen flow, exact component/prop/state details, explicit states, ownership decisions, concrete classes/tokens, risks, acceptance criteria, tests, and implementation sequence \`{ENTRY_POINT_ROLE}\` needs to coordinate implementation. It must not contain implementation edits or alternative designs.`;
 });
 
 // ../../services/backend/prompts/cli/roles/verifier.ts
@@ -110304,7 +110654,7 @@ var init_templates = __esm(() => {
     "game-asset-designer": {
       role: "game-asset-designer",
       title: "Game Asset Designer",
-      description: "You are the game asset designer responsible for specifying production-quality game assets (and producing them when the planner allows); you do not implement application code.",
+      description: "You are the game asset designer responsible for specifying and generating production-quality game and UI assets (generation is the default unless the brief says `spec only`); you do not implement application code.",
       responsibilities: [
         "Recover the target, asset request, style reference, and budgets from the planner brief",
         "Inspect the repository for existing assets, naming and folder conventions, and engine import configuration",
@@ -110317,13 +110667,13 @@ var init_templates = __esm(() => {
     verifier: {
       role: "verifier",
       title: "Verifier",
-      description: "You are the verifier responsible for judging, from chatroom logs only, whether the user's last message was achieved; you do not implement, test, or inspect code.",
+      description: "You are the verifier responsible for judging, from chatroom logs only, whether the user's last message was achieved; you do not implement, build, or edit code, and you run only the tests the user explicitly asked for.",
       responsibilities: [
         "Recover the user's last message and the pinned context from the chatroom logs",
         "Break the objective into numbered requirements",
         "Check each requirement against concrete evidence in the logs, treating the planner claim as unverified",
         "Return one verdict (ACHIEVED, NOT_ACHIEVED, or INCONCLUSIVE) with evidence and the missing items",
-        "Execute nothing: no tests, builds, or repository inspection"
+        "Execute nothing except the tests the user explicitly asked for: no builds, lints, or edits"
       ],
       defaultHandoffTarget: "planner"
     },
@@ -118959,7 +119309,7 @@ function parseYaml(text) {
   }
 }
 function validateFields(data, body) {
-  if (!isPlainObject3(data))
+  if (!isPlainObject4(data))
     return fail6("invalid-frontmatter", "frontmatter is not a mapping");
   const name = data.name;
   if (!isValidName(name))
@@ -118969,7 +119319,7 @@ function validateFields(data, body) {
     return fail6("invalid-description");
   return { ok: true, name, description, body };
 }
-function isPlainObject3(value2) {
+function isPlainObject4(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 function isValidName(value2) {
@@ -118989,7 +119339,7 @@ var init_parse_skill_file = __esm(() => {
 });
 
 // src/infrastructure/external-skills/discover-external-skills.ts
-import { lstat as lstat2, readdir as readdir2, readFile as readFile8, realpath, stat as stat6 } from "node:fs/promises";
+import { lstat as lstat2, readdir as readdir2, readFile as readFile9, realpath, stat as stat6 } from "node:fs/promises";
 import os2 from "node:os";
 import { join as join20 } from "node:path";
 function errorCode(err) {
@@ -119097,7 +119447,7 @@ async function isSymlink2(path3) {
 }
 async function readSkillFile(sourcePath, issues) {
   try {
-    return await readFile8(join20(sourcePath, SKILL_FILE_NAME), "utf8");
+    return await readFile9(join20(sourcePath, SKILL_FILE_NAME), "utf8");
   } catch (err) {
     issues.push(issue2(sourcePath, "unreadable", errorCode(err)));
     return;
@@ -121588,7 +121938,7 @@ var init_orphan_tracker = __esm(() => {
 });
 
 // src/daemon/entry/handlers/process/output-store.ts
-import { appendFile as appendFile2, mkdir as mkdir10, readFile as readFile9, rm as rm2 } from "node:fs/promises";
+import { appendFile as appendFile2, mkdir as mkdir10, readFile as readFile10, rm as rm2 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join as join23 } from "node:path";
 
@@ -121621,7 +121971,7 @@ class TempFileOutputStore {
   async getLastNLines(maxLines) {
     let source;
     try {
-      source = await readFile9(this.state.filePath, "utf-8");
+      source = await readFile10(this.state.filePath, "utf-8");
     } catch {
       source = this.state.inMemory;
     }
@@ -121638,7 +121988,7 @@ class TempFileOutputStore {
   }
   async getFullOutput() {
     try {
-      return await readFile9(this.state.filePath, "utf-8");
+      return await readFile10(this.state.filePath, "utf-8");
     } catch {
       return this.state.inMemory;
     }
@@ -123268,7 +123618,7 @@ var init_workspace_visibility_policy = __esm(() => {
 
 // src/infrastructure/services/workspace/workspace-ignore.ts
 import { promises as fsPromises } from "node:fs";
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 import { homedir as homedir11 } from "node:os";
 import path3 from "node:path";
 function normalizeRelativePath(relativePath) {
@@ -123333,7 +123683,7 @@ async function loadGitExtraExcludeRuleSets(rootDir) {
 }
 async function readIgnoreFile(filePath) {
   try {
-    return await readFile10(filePath, "utf-8");
+    return await readFile11(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -127928,7 +128278,7 @@ function parseMakefileTargets(content) {
 var MAX_NAME_LENGTH2 = 256;
 
 // src/infrastructure/services/workspace/workspace-resolver.ts
-import { readFile as readFile12, readdir as readdir5, stat as stat10 } from "node:fs/promises";
+import { readFile as readFile13, readdir as readdir5, stat as stat10 } from "node:fs/promises";
 import { join as join28, basename as basename7, resolve as resolve10 } from "node:path";
 async function resolveGlobPatternStar(rootDir, cleaned) {
   const parentDir2 = join28(rootDir, cleaned.slice(0, -2));
@@ -127969,7 +128319,7 @@ async function resolveGlobPattern(rootDir, pattern) {
 }
 async function readPackageJson(dir) {
   try {
-    const content = await readFile12(join28(dir, "package.json"), "utf-8");
+    const content = await readFile13(join28(dir, "package.json"), "utf-8");
     const pkg = JSON.parse(content);
     return {
       name: pkg.name || basename7(dir),
@@ -127981,7 +128331,7 @@ async function readPackageJson(dir) {
 }
 async function readPnpmWorkspacePatterns(rootDir) {
   try {
-    const content = await readFile12(join28(rootDir, "pnpm-workspace.yaml"), "utf-8");
+    const content = await readFile13(join28(rootDir, "pnpm-workspace.yaml"), "utf-8");
     const patterns = [];
     let inPackages = false;
     for (const line of content.split(`
@@ -128008,7 +128358,7 @@ async function readPnpmWorkspacePatterns(rootDir) {
 }
 async function readPackageJsonWorkspacePatterns(rootDir) {
   try {
-    const content = await readFile12(join28(rootDir, "package.json"), "utf-8");
+    const content = await readFile13(join28(rootDir, "package.json"), "utf-8");
     const pkg = JSON.parse(content);
     if (!pkg.workspaces)
       return [];
@@ -128056,7 +128406,7 @@ async function resolveSubWorkspaces(rootDir, pm) {
 var init_workspace_resolver = () => {};
 
 // src/infrastructure/services/workspace/command-discovery.ts
-import { access as access2, readFile as readFile13 } from "node:fs/promises";
+import { access as access2, readFile as readFile14 } from "node:fs/promises";
 import { join as join29, relative as relative3, basename as basename8 } from "node:path";
 async function detectPackageManager(workingDir) {
   for (const { file: file2, manager } of LOCKFILE_MAP) {
@@ -128105,7 +128455,7 @@ function isValidScriptEntry(name, script) {
 }
 async function readJsonFile(filePath, label) {
   try {
-    const content = await readFile13(filePath, "utf-8");
+    const content = await readFile14(filePath, "utf-8");
     return parseJsonc2(content);
   } catch (error51) {
     if (error51.code !== "ENOENT") {
@@ -128182,7 +128532,7 @@ async function readMakefile(workingDir) {
   const commands = [];
   for (const fileName of ["Makefile", "makefile"]) {
     try {
-      const content = await readFile13(join29(workingDir, fileName), "utf-8");
+      const content = await readFile14(join29(workingDir, fileName), "utf-8");
       const targets = parseMakefileTargets(content);
       if (targets.length === 0)
         continue;
@@ -134302,7 +134652,7 @@ function gunzipBase64Payload(base643, maxBytes) {
 var init_workspace_path_security = () => {};
 
 // src/daemon/entry/files/file-content-fulfillment.ts
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 import { gzipSync as gzipSync3 } from "node:zlib";
 function getErrorCause(error51) {
   if (typeof error51 === "object" && error51 !== null && "cause" in error51 && error51.cause !== undefined) {
@@ -134377,7 +134727,7 @@ var init_file_content_fulfillment = __esm(() => {
         continue;
       }
       let fileNotFound = false;
-      const buffer = yield* exports_Effect.catch(exports_Effect.tryPromise(() => readFile14(absolutePath)), (error51) => {
+      const buffer = yield* exports_Effect.catch(exports_Effect.tryPromise(() => readFile15(absolutePath)), (error51) => {
         if (isENOENT(error51)) {
           fileNotFound = true;
           return exports_Effect.succeed(Buffer.alloc(0));
@@ -146086,9 +146436,10 @@ var {
 } = import__.default;
 
 // src/commands/generate/index.ts
-import { readFile, stat as stat2 } from "node:fs/promises";
+import { readFile as readFile2, stat as stat2 } from "node:fs/promises";
 init_image();
 init_local_image_common();
+init_model_capabilities();
 var OUTPUT_FORMATS = ["png", "webp"];
 function parsePlatform(value) {
   if (!GENERATE_IMAGE_PLATFORMS.includes(value)) {
@@ -146114,7 +146465,7 @@ async function readInputOption(value) {
   if (stats.size > MAX_SIDECAR_BYTES) {
     throw new Error(`--input file is ${stats.size} bytes; the maximum is ${MAX_SIDECAR_BYTES} bytes (1 MiB).`);
   }
-  return parseInputJson(await readFile(path, "utf8"));
+  return parseInputJson(await readFile2(path, "utf8"));
 }
 function parseSeed(value) {
   const seed = Number(value);
@@ -146125,38 +146476,49 @@ function parseSeed(value) {
 }
 var HELP_AFTER = `
 Examples:
-  chatroom generate-image --platform=fal --prompt "a hero" --out hero.png
-  chatroom generate-image --platform=fal --prompt 'pixel-art potion, transparent-friendly flat background' --output-format png --out potion.png
+  chatroom generate-image --platform=fal --model ${FLUX_2_FLASH_MODEL} --prompt "a hero" --out hero.png
+  chatroom generate-image --platform=fal --model ${FLUX_2_FLASH_MODEL} --prompt 'pixel-art potion, transparent-friendly flat background' --output-format png --out potion.png
+  chatroom generate-image --platform=fal --model ${FLUX_2_FLASH_EDIT_MODEL} --prompt "make the sky stormy" --input-image ./hero.png --out hero-stormy.png
 `;
-function registerGenerateImageCommand(program2) {
-  program2.command("generate-image").description("Generate one image with a fal model and write a JSON manifest next to it").requiredOption("--prompt <text>", "Text prompt describing the image").requiredOption("--out <path>", "Output image path (manifest is written to <path>.json)").option("--platform <name>", "Generation platform: fal", parsePlatform, DEFAULT_GENERATE_IMAGE_PLATFORM).option("--model <id>", `fal model id. Recommended and default: ${DEFAULT_IMAGE_MODEL}`, DEFAULT_IMAGE_MODEL).option("--aspect-ratio <ratio>", `Aspect ratio, e.g. 1:1, 4:3, 16:9, 9:16 (omitted = model default). Not supported by the default model ${DEFAULT_IMAGE_MODEL}, which uses its own image size`).option("--output-format <format>", "Output format: png or webp (omitted = model default)", parseOutputFormat).option("--seed <n>", "Seed for the random number generator", parseSeed).option("--input <json|@file>", "Model-specific JSON input object merged into the fal request; @file reads JSON from a file").option("--force", "Overwrite existing output and manifest files").addHelpText("after", HELP_AFTER).action(async (options) => {
-    try {
-      const input = options.input === undefined ? undefined : await readInputOption(options.input);
-      const { createDefaultGenerateImageDeps: createDefaultGenerateImageDeps2 } = await Promise.resolve().then(() => (init_deps(), exports_deps));
-      const result = await generateImage({
-        prompt: options.prompt,
-        out: options.out,
-        platform: options.platform,
-        model: options.model,
-        aspectRatio: options.aspectRatio,
-        outputFormat: options.outputFormat,
-        seed: options.seed,
-        input,
-        force: options.force
-      }, createDefaultGenerateImageDeps2());
-      console.log(`Generated ${result.outPath}`);
-      console.log(`Manifest ${result.manifestPath}`);
-    } catch (err) {
-      console.error(`❌ ${err instanceof Error ? err.message : String(err)}`);
-      process.exitCode = 1;
+async function runGenerateImage(options) {
+  try {
+    const input = options.input === undefined ? undefined : await readInputOption(options.input);
+    const { createDefaultGenerateImageDeps: createDefaultGenerateImageDeps2 } = await Promise.resolve().then(() => (init_deps(), exports_deps));
+    const deps = createDefaultGenerateImageDeps2();
+    const generateOptions = {
+      prompt: options.prompt,
+      out: options.out,
+      platform: options.platform,
+      model: options.model,
+      aspectRatio: options.aspectRatio,
+      outputFormat: options.outputFormat,
+      seed: options.seed,
+      input,
+      inputImage: options.inputImage,
+      force: options.force
+    };
+    if (options.dryRun === true) {
+      const { formatGenerateImagePlan: formatGenerateImagePlan2, planGenerateImage: planGenerateImage2 } = await Promise.resolve().then(() => (init_image(), exports_image));
+      console.log(formatGenerateImagePlan2(await planGenerateImage2(generateOptions, deps)));
+      return;
     }
-  });
+    const result = await generateImage(generateOptions, deps);
+    console.log(`Generated ${result.outPath}`);
+    console.log(`Manifest ${result.manifestPath}`);
+  } catch (err) {
+    console.error(`❌ ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+  }
+}
+function registerGenerateImageCommand(program2) {
+  program2.command("generate-image").description("Generate one image with a fal model and write a JSON manifest next to it").requiredOption("--prompt <text>", "Text prompt describing the image").requiredOption("--out <path>", "Output image path (manifest is written to <path>.json)").option("--platform <name>", "Generation platform: fal", parsePlatform, DEFAULT_GENERATE_IMAGE_PLATFORM).requiredOption("--model <id>", `fal model id (required), for example ${FLUX_2_FLASH_MODEL}, or ${FLUX_2_FLASH_EDIT_MODEL} with --input-image`).option("--aspect-ratio <ratio>", "Aspect ratio for models that take one, e.g. 1:1, 16:9 (omitted = model default). Rejected for models the CLI knows do not support it").option("--output-format <format>", "Output format: png or webp (omitted = model default)", parseOutputFormat).option("--seed <n>", "Seed for the random number generator", parseSeed).option("--input <json|@file>", "Model-specific JSON input object merged into the fal request; @file reads JSON from a file").option("--input-image <path-or-url>", `Image to edit: a local .png, .jpg, .jpeg, .webp, or .gif (uploaded to fal) or an http(s) URL. Requires an edit model such as ${FLUX_2_FLASH_EDIT_MODEL}`).option("--force", "Overwrite existing output and manifest files").option("--dry-run", "Validate and print the request and the model constraints the CLI knows, without uploading or calling fal (FAL_API_KEY not needed)").addHelpText("after", HELP_AFTER).action(runGenerateImage);
 }
 
 // src/commands/generate/remove-background.ts
 import { basename, dirname as dirname3, extname as extname2, join as join2, resolve as resolve2 } from "node:path";
 
 // src/commands/generate/background-key.ts
+init_local_image_common();
 var DEFAULT_TOLERANCE = 24;
 var DEFAULT_MIN_AREA_PERCENT = 0.5;
 var BORDER_NOISE_REFUSAL_RATIO = 0.02;
@@ -146174,13 +146536,6 @@ function borderCoordinates(width, height) {
   }
   return coordinates;
 }
-function median(values) {
-  const sorted = [...values].sort((a, b) => a - b);
-  const middle = Math.floor(sorted.length / 2);
-  if (sorted.length % 2 === 1)
-    return sorted[middle] ?? 0;
-  return Math.round(((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2);
-}
 function forEachNeighbour(index, width, height, visit) {
   const x = index % width;
   const y = Math.floor(index / width);
@@ -147313,14 +147668,7 @@ function mostFrequentBorderColor(image) {
   }
   if (red.length === 0)
     return null;
-  const median2 = (values) => {
-    const sorted = [...values].sort((a, b) => a - b);
-    const middle = Math.floor(sorted.length / 2);
-    if (sorted.length % 2 === 1)
-      return sorted[middle] ?? 0;
-    return Math.round(((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2);
-  };
-  return [median2(red), median2(green), median2(blue)];
+  return [median(red), median(green), median(blue)];
 }
 function countCellEdgeForeground(image, cell, background) {
   const { width, height, data } = image;
@@ -147408,7 +147756,7 @@ async function sliceImage(opts, deps) {
     throw new SliceImageError(`--in is ${bytes.byteLength} bytes; the maximum is ${MAX_SOURCE_BYTES} bytes (64 MiB).`);
   }
   if (!hasPngMagic(bytes)) {
-    throw new SliceImageError("--in is not a PNG. slice-image only reads PNG sheets; regenerate with 'chatroom generate-image --output-format png' (the default model returns PNG).");
+    throw new SliceImageError("--in is not a PNG. slice-image only reads PNG sheets; regenerate with 'chatroom generate-image --model <id> --output-format png'.");
   }
   const dimensions = readPngDimensions(bytes);
   if (dimensions === null) {
@@ -148369,4 +148717,4 @@ program2.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program2.parse();
 
-//# debugId=CBBD6308FFB368C664756E2164756E21
+//# debugId=E840D0ACF405C0D664756E2164756E21