chatroom-cli 1.136.0 → 1.137.0

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: {
@@ -107914,7 +108227,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 +108241,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,11 +108266,14 @@ 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\`>
@@ -107968,7 +108285,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>
@@ -108028,7 +108345,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>
@@ -109980,7 +110297,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 +110336,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.
 
@@ -118959,7 +119285,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 +119295,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 +119315,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 +119423,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 +121914,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 +121947,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 +121964,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 +123594,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 +123659,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 +128254,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 +128295,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 +128307,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 +128334,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 +128382,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 +128431,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 +128508,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 +134628,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 +134703,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 +146412,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 +146441,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 +146452,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 +146512,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 +147644,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 +147732,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 +148693,4 @@ program2.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program2.parse();
 
-//# debugId=CBBD6308FFB368C664756E2164756E21
+//# debugId=0C6C6A8595C191FE64756E2164756E21