chatroom-cli 1.137.1 → 1.137.3

package/dist/index.js

@@ -2140,7 +2140,241 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
-// src/commands/generate/model-capabilities.ts
+// src/commands/image-shared/image-preflight.ts
+import { createHash } from "node:crypto";
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function sha256(bytes) {
+  return createHash("sha256").update(bytes).digest("hex");
+}
+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;
+  return PNG_MAGIC.every((byte, index) => bytes[index] === byte);
+}
+function readPngDimensions(bytes) {
+  if (bytes.length < 24)
+    return null;
+  if (bytes[12] !== 73 || bytes[13] !== 72 || bytes[14] !== 68 || bytes[15] !== 82) {
+    return null;
+  }
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  return { width: view.getUint32(16), height: view.getUint32(20) };
+}
+function formatConflicts(conflicts) {
+  const shown = conflicts.slice(0, 10);
+  const lines = shown.map((conflict) => `- ${conflict.path}: ${conflict.reason}`);
+  if (conflicts.length > shown.length) {
+    lines.push(`- and ${conflicts.length - shown.length} more`);
+  }
+  return `Refusing to write ${conflicts.length} output file(s):
+${lines.join(`
+`)}
+Pass --force to overwrite.`;
+}
+async function findOutputConflicts(deps, paths, sourcePaths, sourceIdentities, force) {
+  const matchesSourceIdentity = (identity) => sourceIdentities.some((source) => source !== null && source.dev === identity.dev && source.ino === identity.ino);
+  const conflicts = [];
+  for (const path of paths) {
+    if (sourcePaths.has(path)) {
+      conflicts.push({ path, reason: "this is the source sheet or its manifest" });
+      continue;
+    }
+    if (await deps.isSymlink(path)) {
+      conflicts.push({ path, reason: "this is a symbolic link" });
+      continue;
+    }
+    const status = await deps.pathStatus(path);
+    if (status === "directory") {
+      conflicts.push({ path, reason: "a directory is in the way" });
+      continue;
+    }
+    const identity = await deps.fileIdentity(path);
+    if (identity !== null && matchesSourceIdentity(identity)) {
+      conflicts.push({ path, reason: "this resolves to the source sheet or its manifest" });
+      continue;
+    }
+    if (status === "file" && !force) {
+      conflicts.push({ path, reason: "already exists" });
+    }
+  }
+  return conflicts;
+}
+var SAFE_NAME, MAX_SOURCE_PIXELS = 1e8, MAX_SOURCE_BYTES, MAX_SIDECAR_BYTES, PNG_MAGIC;
+var init_image_preflight = __esm(() => {
+  SAFE_NAME = /^[A-Za-z0-9_][A-Za-z0-9_-]{0,63}$/;
+  MAX_SOURCE_BYTES = 64 * 1024 * 1024;
+  MAX_SIDECAR_BYTES = 1024 * 1024;
+  PNG_MAGIC = new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]);
+});
+
+// src/commands/generate-image/fal-pricing.ts
+function listUnitPrices(endpointIds) {
+  const prices = new Map;
+  for (const endpointId of endpointIds) {
+    const fallback = LIST_PRICES[endpointId];
+    if (fallback !== undefined) {
+      prices.set(endpointId, { endpointId, ...fallback, rateSource: "list" });
+    }
+  }
+  return prices;
+}
+function parseLivePrice(entry) {
+  if (!isRecord(entry))
+    return;
+  const { endpoint_id, unit_price, unit, currency } = entry;
+  if (typeof endpoint_id !== "string" || endpoint_id.length === 0)
+    return;
+  if (typeof unit_price !== "number" || !Number.isFinite(unit_price) || unit_price < 0) {
+    return;
+  }
+  if (typeof unit !== "string" || unit.length === 0)
+    return;
+  if (currency !== undefined && currency !== "USD")
+    return;
+  return { endpointId: endpoint_id, unitPrice: unit_price, unit, rateSource: "live" };
+}
+function livePricesByEndpoint(body) {
+  const prices = new Map;
+  if (!isRecord(body) || !Array.isArray(body.prices))
+    return prices;
+  for (const entry of body.prices) {
+    const price = parseLivePrice(entry);
+    if (price !== undefined)
+      prices.set(price.endpointId, price);
+  }
+  return prices;
+}
+async function lookupFalUnitPrices(endpointIds, deps) {
+  const ids = [...new Set(endpointIds)];
+  const key = deps.env.FAL_API_KEY?.trim();
+  if (!key || ids.length === 0)
+    return listUnitPrices(ids);
+  try {
+    const url = new URL(PRICING_URL);
+    for (const endpointId of ids)
+      url.searchParams.append("endpoint_id", endpointId);
+    const body = await deps.getJson(url.toString(), { Authorization: `Key ${key}` }, PRICING_TIMEOUT_MS);
+    const live = livePricesByEndpoint(body);
+    const list = listUnitPrices(ids);
+    const prices = new Map;
+    for (const endpointId of ids) {
+      const price = live.get(endpointId) ?? list.get(endpointId);
+      if (price !== undefined)
+        prices.set(endpointId, price);
+    }
+    return prices;
+  } catch {
+    return listUnitPrices(ids);
+  }
+}
+async function lookupUnitPrice(endpointId, lookupPrices) {
+  try {
+    const price = (await lookupPrices([endpointId])).get(endpointId);
+    if (price !== undefined)
+      return price;
+  } catch {}
+  return listUnitPrices([endpointId]).get(endpointId);
+}
+function estimateUsd(price, quantity) {
+  return quantity * price.unitPrice;
+}
+function formatUsd(value) {
+  if (!Number.isFinite(value))
+    return "unknown";
+  if (value === 0)
+    return "$0";
+  const magnitude = Math.floor(Math.log10(Math.abs(value)));
+  const decimals = Math.min(12, Math.max(4, 3 - magnitude));
+  return `$${value.toFixed(decimals)}`;
+}
+function imageSizeMegapixels(imageSize) {
+  if (typeof imageSize === "string") {
+    const preset = IMAGE_SIZE_PRESETS[imageSize];
+    if (preset === undefined)
+      return;
+    return preset.width * preset.height / 1e6;
+  }
+  if (!Number.isFinite(imageSize.width) || !Number.isFinite(imageSize.height) || imageSize.width <= 0 || imageSize.height <= 0) {
+    return;
+  }
+  return imageSize.width * imageSize.height / 1e6;
+}
+function displayUnit(unit) {
+  return DISPLAY_UNITS[unit] ?? unit;
+}
+function formatRate(price) {
+  return `${formatUsd(price.unitPrice)} per ${displayUnit(price.unit)}`;
+}
+function formatRateSource(price) {
+  return price.rateSource === "live" ? "live rate for this account" : `list price as of ${LIST_PRICES_AS_OF}; live lookup unavailable`;
+}
+function formatCostEstimate(price, quantity, quantityLabel) {
+  return `${formatRate(price)} (${formatRateSource(price)}) × ${quantityLabel} ≈ ${formatUsd(estimateUsd(price, quantity))}`;
+}
+function formatCostDisclosure(disclosure, label = "Cost") {
+  if (disclosure.kind === "unknown") {
+    return `${label}: unknown for ${disclosure.model}; no rate data.`;
+  }
+  if (disclosure.kind === "rate-only") {
+    return `${label} (rate only): ${formatRate(disclosure.price)} (${formatRateSource(disclosure.price)}). ${disclosure.reason}`;
+  }
+  const estimateLabel = label === "Estimated cost" ? label : `${label} (estimate)`;
+  return `${estimateLabel}: ${formatCostEstimate(disclosure.price, disclosure.quantity, disclosure.quantityLabel)}`;
+}
+function createDefaultFalPricingDeps(env = process.env) {
+  return {
+    env,
+    getJson: async (url, headers, timeoutMs) => {
+      const response = await fetch(url, {
+        headers: { Accept: "application/json", ...headers },
+        signal: AbortSignal.timeout(timeoutMs),
+        redirect: "error"
+      });
+      if (!response.ok) {
+        throw new Error(`fal pricing lookup failed (HTTP ${response.status})`);
+      }
+      return await response.json();
+    }
+  };
+}
+var LIST_PRICES_AS_OF = "2026-10-25", LIST_PRICES, IMAGE_SIZE_PRESETS, PRICING_TIMEOUT_MS = 3000, PRICING_URL = "https://api.fal.ai/v1/models/pricing", DISPLAY_UNITS;
+var init_fal_pricing = __esm(() => {
+  init_image_preflight();
+  LIST_PRICES = {
+    "fal-ai/flux-2/flash": { unitPrice: 0.005, unit: "megapixels" },
+    "fal-ai/flux-2/flash/edit": { unitPrice: 0.005, unit: "processed megapixels" },
+    "fal-ai/bria/background/remove": { unitPrice: 0.018, unit: "generations" },
+    "fal-ai/birefnet/v2": { unitPrice: 0.000575, unit: "compute seconds" }
+  };
+  IMAGE_SIZE_PRESETS = {
+    square_hd: { width: 1024, height: 1024 },
+    square: { width: 512, height: 512 },
+    portrait_4_3: { width: 768, height: 1024 },
+    portrait_16_9: { width: 576, height: 1024 },
+    landscape_4_3: { width: 1024, height: 768 },
+    landscape_16_9: { width: 1024, height: 576 }
+  };
+  DISPLAY_UNITS = {
+    megapixels: "megapixel",
+    "processed megapixels": "processed megapixel",
+    generations: "generation",
+    "compute seconds": "compute second"
+  };
+});
+
+// src/commands/generate-image/model-capabilities.ts
 function getModelCapability(id) {
   return Object.prototype.hasOwnProperty.call(MODEL_CAPABILITIES, id) ? MODEL_CAPABILITIES[id] : undefined;
 }
@@ -2278,7 +2512,7 @@ var init_model_capabilities = __esm(() => {
   };
 });
 
-// src/commands/generate/image.ts
+// src/commands/generate-image/image.ts
 var exports_image = {};
 __export(exports_image, {
   planGenerateImage: () => planGenerateImage,
@@ -2290,7 +2524,7 @@ __export(exports_image, {
   FAL_API_KEY_MISSING_MESSAGE: () => FAL_API_KEY_MISSING_MESSAGE,
   DEFAULT_GENERATE_IMAGE_PLATFORM: () => DEFAULT_GENERATE_IMAGE_PLATFORM
 });
-import { createHash } from "node:crypto";
+import { createHash as createHash2 } from "node:crypto";
 import { extname, resolve } from "node:path";
 function resolvePlatform(platform) {
   return platform ?? DEFAULT_GENERATE_IMAGE_PLATFORM;
@@ -2494,6 +2728,155 @@ async function uploadInputImage(deps, target) {
   const url = await deps.uploadFile(target.path, target.contentType);
   return { url, record: { source: target.path, url } };
 }
+function formatMegapixels(megapixels) {
+  return `${megapixels.toFixed(2)} MP`;
+}
+function readImageSizeValue(value) {
+  if (typeof value === "string")
+    return value;
+  if (isPlainObject(value) && typeof value.width === "number" && typeof value.height === "number") {
+    return { width: value.width, height: value.height };
+  }
+  return;
+}
+function plannedOutputSize(model, input) {
+  const capability = getModelCapability(model);
+  const support = capability?.params.image_size;
+  const value = input.image_size !== undefined ? input.image_size : support?.support === "supported" ? support.default : undefined;
+  if (value === undefined) {
+    return {
+      megapixels: undefined,
+      reason: "The image_size is unset and the model has no known default; output size not estimated."
+    };
+  }
+  const size = readImageSizeValue(value);
+  if (size === undefined) {
+    return {
+      megapixels: undefined,
+      reason: `The image_size ${JSON.stringify(value)} is not a preset name or {width,height}; output size not estimated.`
+    };
+  }
+  const megapixels = imageSizeMegapixels(size);
+  if (megapixels === undefined) {
+    return {
+      megapixels: undefined,
+      reason: `The image_size ${JSON.stringify(value)} is not a known preset; output size not estimated.`
+    };
+  }
+  return { megapixels, reason: undefined };
+}
+async function inputSizeNote(deps, target) {
+  if (target === undefined)
+    return EDIT_INPUT_NOTE;
+  if (target.kind === "url") {
+    return "Input is a URL; fal resizes it to 1 MP, so the estimate counts 1 MP of input.";
+  }
+  if (target.contentType !== "image/png") {
+    return "Input is not a PNG; fal resizes it to 1 MP, so the estimate counts 1 MP of input.";
+  }
+  try {
+    const dimensions = readPngDimensions(await deps.readFileBytes(target.path));
+    if (dimensions === null || dimensions.width === 0 || dimensions.height === 0) {
+      return EDIT_INPUT_NOTE;
+    }
+    const megapixels = dimensions.width * dimensions.height / 1e6;
+    return `Input is ${dimensions.width}x${dimensions.height} (${formatMegapixels(megapixels)}); fal resizes it to 1 MP, so the estimate counts 1 MP of input.`;
+  } catch {
+    return EDIT_INPUT_NOTE;
+  }
+}
+async function lookupPrice(deps, model) {
+  return lookupUnitPrice(model, (ids) => deps.lookupPrices(ids));
+}
+async function buildGenerateImageCost(args) {
+  const price = await lookupPrice(args.deps, args.model);
+  const output = plannedOutputSize(args.model, args.input);
+  const capability = getModelCapability(args.model);
+  if (capability?.task === "image-edit") {
+    const notes = [
+      "Formula (unverified): (1 MP input + output MP) × rate.",
+      await inputSizeNote(args.deps, args.inputTarget)
+    ];
+    if (output.megapixels === undefined) {
+      return {
+        price,
+        quantity: undefined,
+        quantityLabel: undefined,
+        inputMegapixels: EDIT_INPUT_MEGAPIXELS,
+        reason: output.reason,
+        notes
+      };
+    }
+    const quantity = EDIT_INPUT_MEGAPIXELS + output.megapixels;
+    return {
+      price,
+      quantity,
+      quantityLabel: `${formatMegapixels(quantity)} (${formatMegapixels(EDIT_INPUT_MEGAPIXELS)} input + ${formatMegapixels(output.megapixels)} output)`,
+      inputMegapixels: EDIT_INPUT_MEGAPIXELS,
+      reason: undefined,
+      notes
+    };
+  }
+  if (output.megapixels === undefined) {
+    return {
+      price,
+      quantity: undefined,
+      quantityLabel: undefined,
+      inputMegapixels: undefined,
+      reason: output.reason,
+      notes: []
+    };
+  }
+  return {
+    price,
+    quantity: output.megapixels,
+    quantityLabel: `${formatMegapixels(output.megapixels)} (planned output)`,
+    inputMegapixels: undefined,
+    reason: undefined,
+    notes: []
+  };
+}
+function formatGenerateImageCost(cost, model, label = "Cost") {
+  const disclosure = cost.price === undefined ? { kind: "unknown", model } : cost.quantity === undefined ? {
+    kind: "rate-only",
+    model,
+    price: cost.price,
+    reason: cost.reason ?? "Quantity not estimated."
+  } : {
+    kind: "estimate",
+    model,
+    price: cost.price,
+    quantity: cost.quantity,
+    quantityLabel: cost.quantityLabel ?? formatMegapixels(cost.quantity)
+  };
+  const note = cost.price === undefined ? [] : [cost.quantity === undefined ? ACTUAL_COST_NOTE : PLANNED_COST_NOTE];
+  return [formatCostDisclosure(disclosure, label), ...note, ...cost.notes];
+}
+function actualCostLines(plan, image) {
+  const { price, inputMegapixels } = plan.cost;
+  if (price === undefined) {
+    return formatGenerateImageCost(plan.cost, plan.model, "Estimated cost");
+  }
+  const width = image.width;
+  const height = image.height;
+  const hasDimensions = width !== undefined && height !== undefined && Number.isFinite(width) && Number.isFinite(height) && width > 0 && height > 0;
+  if (!hasDimensions) {
+    if (plan.cost.quantity === undefined) {
+      return formatGenerateImageCost(plan.cost, plan.model, "Estimated cost");
+    }
+    return [
+      `Estimated cost (planned size): ${formatCostEstimate(price, plan.cost.quantity, plan.cost.quantityLabel ?? formatMegapixels(plan.cost.quantity))}`,
+      ACTUAL_COST_NOTE
+    ];
+  }
+  const outputMegapixels = width * height / 1e6;
+  const quantity = inputMegapixels === undefined ? outputMegapixels : inputMegapixels + outputMegapixels;
+  const quantityLabel = inputMegapixels === undefined ? `${formatMegapixels(outputMegapixels)} (actual ${width}x${height})` : `${formatMegapixels(quantity)} (actual ${width}x${height}; ${formatMegapixels(inputMegapixels)} input + ${formatMegapixels(outputMegapixels)} output)`;
+  return [
+    `Estimated cost: ${formatCostEstimate(price, quantity, quantityLabel)}`,
+    ACTUAL_COST_NOTE
+  ];
+}
 async function planGenerateImage(opts, deps) {
   const platform = resolvePlatform(opts.platform);
   requireSupportedPlatform(platform);
@@ -2511,6 +2894,7 @@ async function planGenerateImage(opts, deps) {
   const manifestPath = `${outPath}.json`;
   await requireWritableOutput(deps, outPath, manifestPath, opts.force === true);
   const input = buildInput(prompt, opts, planInputImageUrl(inputTarget));
+  const cost = await buildGenerateImageCost({ model, input, inputTarget, deps });
   return {
     platform,
     model,
@@ -2518,7 +2902,8 @@ async function planGenerateImage(opts, deps) {
     manifestPath,
     input,
     inputTarget,
-    disclosures: describeConstraints(model, input, { aspectRatio: opts.aspectRatio })
+    disclosures: describeConstraints(model, input, { aspectRatio: opts.aspectRatio }),
+    cost
   };
 }
 function disclosureFlag(key) {
@@ -2548,7 +2933,8 @@ function formatGenerateImagePlan(plan) {
   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.");
+  lines.push(...formatGenerateImageCost(plan.cost, plan.model));
+  lines.push("No upload or fal generation call was made.");
   return lines.join(`
 `);
 }
@@ -2563,7 +2949,7 @@ async function generateAndSave(deps, model, input, outPath) {
   return {
     image,
     bytes,
-    sha256: createHash("sha256").update(bytes).digest("hex"),
+    sha256: createHash2("sha256").update(bytes).digest("hex"),
     requestId: result.requestId,
     seed: result.data.seed
   };
@@ -2576,10 +2962,14 @@ async function generateImage(opts, deps) {
       deps.warn(`⚠️ ${disclosure.key}: ${disclosure.message}`);
     }
   }
+  for (const line of formatGenerateImageCost(plan.cost, plan.model)) {
+    deps.log(line);
+  }
   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);
+  const costLines = actualCostLines(plan, saved.image);
   await deps.writeJson(plan.manifestPath, buildManifest({
     platform: plan.platform,
     model: plan.model,
@@ -2595,11 +2985,18 @@ async function generateImage(opts, deps) {
     generatedAt: deps.now().toISOString(),
     sdkVersion: deps.sdkVersion
   }));
-  return { outPath: plan.outPath, manifestPath: plan.manifestPath, sha256: saved.sha256 };
+  return {
+    outPath: plan.outPath,
+    manifestPath: plan.manifestPath,
+    sha256: saved.sha256,
+    costLines
+  };
 }
-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 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, PLANNED_COST_NOTE = "fal returns no billed cost; this is computed from the planned image size.", ACTUAL_COST_NOTE = "fal returns no billed cost; check the fal dashboard for the actual bill.", EDIT_INPUT_MEGAPIXELS = 1, EDIT_INPUT_NOTE = "fal resizes the input image to 1 MP; the estimate counts 1 MP of input regardless of its dimensions.";
 var init_image = __esm(() => {
+  init_fal_pricing();
   init_model_capabilities();
+  init_image_preflight();
   GENERATE_IMAGE_PLATFORMS = ["fal"];
   GenerateImageError = class GenerateImageError extends Error {
     constructor(message) {
@@ -2629,85 +3026,6 @@ var init_image = __esm(() => {
   HTTP_URL_PATTERN = /^https?:\/\//i;
 });
 
-// src/commands/generate/local-image-common.ts
-import { createHash as createHash2 } from "node:crypto";
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function sha256(bytes) {
-  return createHash2("sha256").update(bytes).digest("hex");
-}
-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;
-  return PNG_MAGIC.every((byte, index) => bytes[index] === byte);
-}
-function readPngDimensions(bytes) {
-  if (bytes.length < 24)
-    return null;
-  if (bytes[12] !== 73 || bytes[13] !== 72 || bytes[14] !== 68 || bytes[15] !== 82) {
-    return null;
-  }
-  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-  return { width: view.getUint32(16), height: view.getUint32(20) };
-}
-function formatConflicts(conflicts) {
-  const shown = conflicts.slice(0, 10);
-  const lines = shown.map((conflict) => `- ${conflict.path}: ${conflict.reason}`);
-  if (conflicts.length > shown.length) {
-    lines.push(`- and ${conflicts.length - shown.length} more`);
-  }
-  return `Refusing to write ${conflicts.length} output file(s):
-${lines.join(`
-`)}
-Pass --force to overwrite.`;
-}
-async function findOutputConflicts(deps, paths, sourcePaths, sourceIdentities, force) {
-  const matchesSourceIdentity = (identity) => sourceIdentities.some((source) => source !== null && source.dev === identity.dev && source.ino === identity.ino);
-  const conflicts = [];
-  for (const path of paths) {
-    if (sourcePaths.has(path)) {
-      conflicts.push({ path, reason: "this is the source sheet or its manifest" });
-      continue;
-    }
-    if (await deps.isSymlink(path)) {
-      conflicts.push({ path, reason: "this is a symbolic link" });
-      continue;
-    }
-    const status = await deps.pathStatus(path);
-    if (status === "directory") {
-      conflicts.push({ path, reason: "a directory is in the way" });
-      continue;
-    }
-    const identity = await deps.fileIdentity(path);
-    if (identity !== null && matchesSourceIdentity(identity)) {
-      conflicts.push({ path, reason: "this resolves to the source sheet or its manifest" });
-      continue;
-    }
-    if (status === "file" && !force) {
-      conflicts.push({ path, reason: "already exists" });
-    }
-  }
-  return conflicts;
-}
-var SAFE_NAME, MAX_SOURCE_PIXELS = 1e8, MAX_SOURCE_BYTES, MAX_SIDECAR_BYTES, PNG_MAGIC;
-var init_local_image_common = __esm(() => {
-  SAFE_NAME = /^[A-Za-z0-9_][A-Za-z0-9_-]{0,63}$/;
-  MAX_SOURCE_BYTES = 64 * 1024 * 1024;
-  MAX_SIDECAR_BYTES = 1024 * 1024;
-  PNG_MAGIC = new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]);
-});
-
 // ../../node_modules/.pnpm/@fal-ai+client@1.10.1/node_modules/@fal-ai/client/src/middleware.js
 var require_middleware = __commonJS((exports) => {
   var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
@@ -6736,7 +7054,7 @@ var require_src = __commonJS((exports) => {
   }();
 });
 
-// src/commands/generate/fs-helpers.ts
+// src/commands/image-shared/output-files.ts
 import { stat, writeFile } from "node:fs/promises";
 async function pathStatus(path) {
   try {
@@ -6765,9 +7083,9 @@ async function writeJsonFile(path, value, options = {}) {
   }
   await writeFile(path, text, "utf8");
 }
-var init_fs_helpers = () => {};
+var init_output_files = () => {};
 
-// src/commands/generate/package-version.ts
+// src/commands/image-shared/package-version.ts
 import { readFileSync } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { dirname, join } from "node:path";
@@ -6785,10 +7103,9 @@ function readInstalledPackageVersion(specifier) {
 var UNKNOWN_VERSION = "unknown";
 var init_package_version = () => {};
 
-// src/commands/generate/deps.ts
+// src/commands/generate-image/deps.ts
 var exports_deps = {};
 __export(exports_deps, {
-  fetchBytes: () => fetchBytes,
   createFalRawSubscribe: () => createFalRawSubscribe,
   createDefaultGenerateImageDeps: () => createDefaultGenerateImageDeps
 });
@@ -6828,16 +7145,23 @@ function requireSeed(value) {
   }
   return value;
 }
+function optionalDimension(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : undefined;
+}
 function validateImageFile(value) {
   if (!isRecord2(value)) {
     throw invalidResult("image entry is not an object");
   }
   const content_type = optionalString(value.content_type, "image content_type");
   const file_name = optionalString(value.file_name, "image file_name");
+  const width = optionalDimension(value.width);
+  const height = optionalDimension(value.height);
   return {
     url: requireImageUrl(value.url),
     ...content_type !== undefined ? { content_type } : {},
-    ...file_name !== undefined ? { file_name } : {}
+    ...file_name !== undefined ? { file_name } : {},
+    ...width !== undefined ? { width } : {},
+    ...height !== undefined ? { height } : {}
   };
 }
 function requireData(value) {
@@ -6951,24 +7275,29 @@ async function fetchBytes(url) {
 }
 function createDefaultGenerateImageDeps() {
   const env = process.env;
+  const pricingDeps = createDefaultFalPricingDeps(env);
   return {
     env,
     falSubscribe: createFalSubscribe(env),
     uploadFile: createFalUploadFile(env),
     fetchBytes,
+    readFileBytes: async (path) => new Uint8Array(await readFile(path)),
+    lookupPrices: (ids) => lookupFalUnitPrices(ids, pricingDeps),
     writeFile: writeFileBytes,
     writeJson: writeJsonFile,
     pathStatus,
     ensureParentDir,
     now: () => new Date,
     sdkVersion: readInstalledPackageVersion("@fal-ai/client"),
-    warn: (message) => console.error(message)
+    warn: (message) => console.error(message),
+    log: (message) => console.log(message)
   };
 }
 var import_client, SUBSCRIBE_TIMEOUT_SECONDS = 300;
 var init_deps = __esm(() => {
-  init_fs_helpers();
+  init_fal_pricing();
   init_image();
+  init_output_files();
   init_package_version();
   import_client = __toESM(require_src(), 1);
 });
@@ -8860,7 +9189,7 @@ var require_png = __commonJS((exports) => {
   };
 });
 
-// src/commands/generate/slice-deps.ts
+// src/commands/slice-image/slice-deps.ts
 var exports_slice_deps = {};
 __export(exports_slice_deps, {
   createDefaultSliceImageDeps: () => createDefaultSliceImageDeps
@@ -8947,15 +9276,15 @@ function createDefaultSliceImageDeps() {
 }
 var import_pngjs, PNG;
 var init_slice_deps = __esm(() => {
-  init_fs_helpers();
+  init_output_files();
   init_package_version();
   import_pngjs = __toESM(require_png(), 1);
   ({ PNG } = import_pngjs.default);
 });
 
-// src/commands/generate/remove-background-deps.ts
-var exports_remove_background_deps = {};
-__export(exports_remove_background_deps, {
+// src/commands/remove-image-background/remove-image-background-deps.ts
+var exports_remove_image_background_deps = {};
+__export(exports_remove_image_background_deps, {
   createDefaultRemoveImageBackgroundDeps: () => createDefaultRemoveImageBackgroundDeps
 });
 import { readdir } from "node:fs/promises";
@@ -8965,11 +9294,11 @@ function createDefaultRemoveImageBackgroundDeps() {
     listDir: (dir) => readdir(dir)
   };
 }
-var init_remove_background_deps = __esm(() => {
+var init_remove_image_background_deps = __esm(() => {
   init_slice_deps();
 });
 
-// src/commands/generate/remove-background-fal.ts
+// src/commands/remove-image-background/remove-image-background-fal.ts
 import { basename as basename2, resolve as resolve3 } from "node:path";
 function validateBackgroundResult(raw, model) {
   const unexpected = new RemoveBackgroundFalError(`fal returned no image for ${model}`);
@@ -9046,6 +9375,32 @@ function recoveryMessage2(action, err, requestId, url) {
   const detail = err instanceof Error ? err.message : String(err);
   return `Failed to ${action} image for request ${requestId} (${url}): ${detail}. The result can still be recovered from that URL.`;
 }
+async function findBackgroundPrice(deps, model) {
+  return lookupUnitPrice(model, (ids) => deps.lookupPrices(ids));
+}
+function backgroundCostDisclosure(cost) {
+  if (cost.price === undefined)
+    return { kind: "unknown", model: cost.model };
+  if (cost.engine === "birefnet") {
+    return {
+      kind: "rate-only",
+      model: cost.model,
+      price: cost.price,
+      reason: BIREFNET_RATE_REASON
+    };
+  }
+  return {
+    kind: "estimate",
+    model: cost.model,
+    price: cost.price,
+    quantity: 1,
+    quantityLabel: "1 generation"
+  };
+}
+function formatBackgroundCost(cost, label) {
+  const line = formatCostDisclosure(backgroundCostDisclosure(cost), label);
+  return cost.price === undefined ? [line] : [line, FAL_BILL_NOTE];
+}
 async function removeBackgroundFal(options, deps) {
   if (!deps.env.FAL_API_KEY) {
     throw new RemoveBackgroundFalError(FAL_API_KEY_MISSING_MESSAGE);
@@ -9060,6 +9415,13 @@ async function removeBackgroundFal(options, deps) {
   }
   const source = await requireSource(inPath, deps);
   await requireWritableOutputs(outPath, manifestPath, options.force === true, deps);
+  const cost = {
+    model: spec.model,
+    engine,
+    price: await findBackgroundPrice(deps, spec.model)
+  };
+  for (const line of formatBackgroundCost(cost, "Cost"))
+    deps.log(line);
   const dataUri = `data:image/png;base64,${Buffer.from(source.bytes).toString("base64")}`;
   const raw = await deps.falSubscribe(spec.model, spec.buildInput(dataUri));
   const result = validateBackgroundResult(raw, spec.model);
@@ -9121,6 +9483,8 @@ async function removeBackgroundFal(options, deps) {
   } catch (err) {
     throw new RemoveBackgroundFalError(manifestSaveMessage(err, result.requestId, outPath, manifestPath));
   }
+  for (const line of formatBackgroundCost(cost, "Estimated cost"))
+    deps.log(line);
   return {
     outPath,
     manifestPath,
@@ -9129,10 +9493,11 @@ async function removeBackgroundFal(options, deps) {
     sha256: outputSha256
   };
 }
-var DEFAULT_BACKGROUND_ENGINE = "bria", BACKGROUND_ENGINES, MAX_FAL_INPUT_BYTES, MAX_FAL_RESULT_BYTES, TOOL2 = "chatroom remove-image-background-fal", LICENSING2 = "unverified", RemoveBackgroundFalError;
-var init_remove_background_fal = __esm(() => {
+var DEFAULT_BACKGROUND_ENGINE = "bria", BACKGROUND_ENGINES, MAX_FAL_INPUT_BYTES, MAX_FAL_RESULT_BYTES, TOOL2 = "chatroom remove-image-background-fal", LICENSING2 = "unverified", RemoveBackgroundFalError, FAL_BILL_NOTE = "fal returns no billed cost; check the fal dashboard for the actual bill.", BIREFNET_RATE_REASON = "Total depends on runtime; not estimated.";
+var init_remove_image_background_fal = __esm(() => {
+  init_fal_pricing();
   init_image();
-  init_local_image_common();
+  init_image_preflight();
   BACKGROUND_ENGINES = {
     bria: {
       model: "fal-ai/bria/background/remove",
@@ -9153,9 +9518,9 @@ var init_remove_background_fal = __esm(() => {
   };
 });
 
-// src/commands/generate/remove-background-fal-deps.ts
-var exports_remove_background_fal_deps = {};
-__export(exports_remove_background_fal_deps, {
+// src/commands/remove-image-background/remove-image-background-fal-deps.ts
+var exports_remove_image_background_fal_deps = {};
+__export(exports_remove_image_background_fal_deps, {
   createDefaultRemoveBackgroundFalDeps: () => createDefaultRemoveBackgroundFalDeps
 });
 import { dirname as dirname4 } from "node:path";
@@ -9187,9 +9552,11 @@ async function fetchCappedBytes(url, maxBytes) {
 }
 function createDefaultRemoveBackgroundFalDeps() {
   const slice = createDefaultSliceImageDeps();
+  const pricingDeps = createDefaultFalPricingDeps(process.env);
   return {
     env: process.env,
     falSubscribe: createFalRawSubscribe(process.env),
+    lookupPrices: (ids) => lookupFalUnitPrices(ids, pricingDeps),
     fetchBytes: (url) => fetchCappedBytes(url, MAX_FAL_RESULT_BYTES),
     readInput: slice.readFile,
     statInput: slice.statInput,
@@ -9198,13 +9565,15 @@ function createDefaultRemoveBackgroundFalDeps() {
     writeJson: slice.writeJson,
     ensureParentDir: (path) => slice.ensureDir(dirname4(path)),
     now: () => new Date,
-    sdkVersion: readInstalledPackageVersion("@fal-ai/client")
+    sdkVersion: readInstalledPackageVersion("@fal-ai/client"),
+    log: (message) => console.log(message)
   };
 }
-var init_remove_background_fal_deps = __esm(() => {
+var init_remove_image_background_fal_deps = __esm(() => {
+  init_remove_image_background_fal();
   init_deps();
+  init_fal_pricing();
   init_package_version();
-  init_remove_background_fal();
   init_slice_deps();
 });
 
@@ -108251,7 +108620,7 @@ var init_game_asset_designer_workflow = __esm(() => {
 // ../../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 --model <Model> (dry run first), 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. Before generating anything, the designer evaluates each \`## Free asset candidates\` entry and records a \`use\`, \`adapt\`, or \`reject\` decision; it generates only the assets that no candidate covers.
 
 ## Asset request
 <one to three sentences: what the assets are for and the user-visible goal>
@@ -108283,6 +108652,9 @@ function getEntryPointToGameAssetDesignerHandoffTemplate(query) {
 ## Existing assets
 <repository paths the designer must reuse or must not overwrite; or \`Not specified.\`>
 
+## Free asset candidates
+<one entry per third-party pack to evaluate before generating: pack name, source URL, expected licence (for example CC0), formats, and the asset IDs it could cover; or \`None.\`. The designer checks each pack's own licence file and file sizes and gives each candidate a \`use\`, \`adapt\`, or \`reject\` decision. It fetches only the URLs named here, inspects the pack as static files, and never runs its code.>
+
 ## Deliverable mode
 <\`spec and generate\` (default when you name an output location and allowed tools) or \`spec only\`>
 
@@ -108342,10 +108714,14 @@ ${PROOF_OF_PRINCIPLES_REPORT}
 - [ ] Every asset ID has a file or \`Specified only.\`
 - [ ] Every sliced asset was isolated with \`remove-image-background\` and \`inspected\`.
 - [ ] Manifests are listed in the asset manifest.
+- [ ] Every candidate in the brief has a decision with its licence and file sizes labelled \`inspected\`.
 
 ## Target and assumptions
 <each assumption you made and why; each deviation from the planner's target or budgets; or \`None.\`>
 
+## Free asset decisions
+<one entry per candidate in the brief: pack name, licence quoted from the pack's own licence file, file sizes checked, decision (\`use\`, \`adapt\`, or \`reject\`), asset IDs covered, and the reason; for \`adapt\`, the edits made; write exactly \`None.\` if the brief named no candidates>
+
 ## 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\`, \`--seed\`, \`--input\`, and \`--input-image\` values), the sheet and tile manifests, and the isolated asset manifest path>
 
@@ -146435,11 +146811,11 @@ var {
   Help
 } = import__.default;
 
-// src/commands/generate/index.ts
+// src/commands/generate-image/index.ts
 import { readFile as readFile2, stat as stat2 } from "node:fs/promises";
 init_image();
-init_local_image_common();
 init_model_capabilities();
+init_image_preflight();
 var OUTPUT_FORMATS = ["png", "webp"];
 function parsePlatform(value) {
   if (!GENERATE_IMAGE_PLATFORMS.includes(value)) {
@@ -146479,6 +146855,9 @@ Examples:
   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
+
+Cost lines are estimates: fal returns no billed cost. The rate is live when
+available, otherwise the list price; check the fal dashboard for the actual bill.
 `;
 async function runGenerateImage(options) {
   try {
@@ -146505,20 +146884,30 @@ async function runGenerateImage(options) {
     const result = await generateImage(generateOptions, deps);
     console.log(`Generated ${result.outPath}`);
     console.log(`Manifest ${result.manifestPath}`);
+    for (const line of result.costLines)
+      console.log(line);
   } 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);
+  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, the model constraints the CLI knows, and the estimated fal cost. No upload or fal generation call is made; one read-only pricing request may be made when FAL_API_KEY is set (the key is not required)").addHelpText("after", HELP_AFTER).action(runGenerateImage);
 }
 
-// src/commands/generate/remove-background.ts
+// src/commands/register-chatroom-role-command.ts
+function registerChatroomRoleCommand(program2, config) {
+  program2.command(config.name).description(config.description).requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (e.g., planner, builder)").action(async (options) => {
+    await config.maybeRequireAuth();
+    await config.run(options.chatroomId, { role: options.role });
+  });
+}
+
+// src/commands/remove-image-background/remove-image-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();
+// src/commands/remove-image-background/background-key.ts
+init_image_preflight();
 var DEFAULT_TOLERANCE = 24;
 var DEFAULT_MIN_AREA_PERCENT = 0.5;
 var BORDER_NOISE_REFUSAL_RATIO = 0.02;
@@ -146833,10 +147222,7 @@ function keyBackground(image, opts) {
   });
 }
 
-// src/commands/generate/remove-background.ts
-init_local_image_common();
-
-// src/commands/generate/trim-crop.ts
+// src/commands/remove-image-background/trim-crop.ts
 var MAX_TRIM_PADDING = 64;
 function trimRect(contentBox, canvasWidth, canvasHeight, padding) {
   const x = Math.max(0, contentBox.x - padding);
@@ -146855,7 +147241,9 @@ function cropRgba(data, canvasWidth, rect) {
   return cropped;
 }
 
-// src/commands/generate/remove-background.ts
+// src/commands/remove-image-background/remove-image-background.ts
+init_image_preflight();
+
 class RemoveBackgroundError extends Error {
   constructor(message) {
     super(message);
@@ -147293,7 +147681,7 @@ async function removeImageBackground(opts, deps) {
   return result;
 }
 
-// src/commands/generate/remove-background-command.ts
+// src/commands/remove-image-background/remove-image-background-command.ts
 var DECIMAL_INTEGER = /^\d+$/;
 var DECIMAL_PERCENT = /^\d+(?:\.\d+)?$/;
 function parseTolerance(value) {
@@ -147395,7 +147783,7 @@ function printResult(result) {
 function registerRemoveImageBackgroundCommand(program2) {
   program2.command("remove-image-background").description("Key a tile background to transparency and write an isolated PNG asset").option("--in <png>", "Single input tile PNG").option("--out <png>", "Single output PNG path (must end in .png)").option("--in-dir <dir>", "Directory of input tile PNGs").option("--out-dir <dir>", "Directory for output PNGs and manifests").option("--map <tile=name,...>", "Directory-mode tile stem to output name mapping", parseMap).option("--tolerance <1-128>", "Background colour tolerance", parseTolerance, 24).option("--min-area <percent>", "Smallest kept region as a percent of the tile", parseMinArea, 0.5).option("--allow-edge-content", "Keep artwork that touches the tile border").option("--trim", "Crop each asset to its opaque content").option("--trim-padding <px>", "Pixels kept around trimmed content (0-64, requires --trim)", parseTrimPadding).option("--force", "Overwrite existing outputs").option("--dry-run", "Report the assets without writing anything").addHelpText("after", HELP_AFTER2).action(async (options) => {
     try {
-      const { createDefaultRemoveImageBackgroundDeps: createDefaultRemoveImageBackgroundDeps2 } = await Promise.resolve().then(() => (init_remove_background_deps(), exports_remove_background_deps));
+      const { createDefaultRemoveImageBackgroundDeps: createDefaultRemoveImageBackgroundDeps2 } = await Promise.resolve().then(() => (init_remove_image_background_deps(), exports_remove_image_background_deps));
       const removeOptions = {
         in: options.in,
         out: options.out,
@@ -147419,8 +147807,8 @@ function registerRemoveImageBackgroundCommand(program2) {
   });
 }
 
-// src/commands/generate/remove-background-fal-command.ts
-init_remove_background_fal();
+// src/commands/remove-image-background/remove-image-background-fal-command.ts
+init_remove_image_background_fal();
 var ENGINES = ["bria", "birefnet"];
 function parseEngine(value) {
   if (!ENGINES.includes(value)) {
@@ -147444,8 +147832,10 @@ Model:
   a PNG with alpha.
 
 Billing:
-  bria is billed per call (about $0.018 at the time of writing). birefnet is
-  billed per compute-second.
+  bria is estimated per generation at the live rate, or at the list price of
+  $0.018 (as of 2026-10-25) when the live lookup is unavailable. birefnet is
+  billed per compute second; the rate is shown but the total is not estimated.
+  fal returns no billed cost; check the fal dashboard for the actual bill.
 
 Refusals:
   A missing FAL_API_KEY, a missing or non-PNG input, an input over 8 MiB, an
@@ -147465,7 +147855,7 @@ Examples:
 function registerRemoveImageBackgroundFalCommand(program2) {
   program2.command("remove-image-background-fal").description("Remove an image background with fal.ai and write a transparent PNG").requiredOption("--in <png>", "Input PNG to cut out").requiredOption("--out <png>", "Output PNG path for the image with alpha").option("--engine <engine>", "Background model: bria (default, fal-ai/bria/background/remove) or birefnet (previous BiRefNet Matting backend, fal-ai/birefnet/v2)", parseEngine, DEFAULT_BACKGROUND_ENGINE).option("--force", "Overwrite an existing output and manifest").addHelpText("after", HELP_AFTER3).action(async (options) => {
     try {
-      const { createDefaultRemoveBackgroundFalDeps: createDefaultRemoveBackgroundFalDeps2 } = await Promise.resolve().then(() => (init_remove_background_fal_deps(), exports_remove_background_fal_deps));
+      const { createDefaultRemoveBackgroundFalDeps: createDefaultRemoveBackgroundFalDeps2 } = await Promise.resolve().then(() => (init_remove_image_background_fal_deps(), exports_remove_image_background_fal_deps));
       const result = await removeBackgroundFal({ in: options.in, out: options.out, engine: options.engine, force: options.force }, createDefaultRemoveBackgroundFalDeps2());
       console.log(`Removed background ${result.outPath} (${result.bytes} bytes)`);
       console.log(`Manifest ${result.manifestPath}`);
@@ -147477,8 +147867,8 @@ function registerRemoveImageBackgroundFalCommand(program2) {
   });
 }
 
-// src/commands/generate/slice.ts
-init_local_image_common();
+// src/commands/slice-image/slice.ts
+init_image_preflight();
 import { basename as basename3, extname as extname3, join as join3, resolve as resolve4 } from "node:path";
 var SLICE_TOOL = "chatroom slice-image";
 var MAX_TILES = 256;
@@ -147974,7 +148364,7 @@ async function sliceImage(opts, deps) {
   return result;
 }
 
-// src/commands/generate/slice-command.ts
+// src/commands/slice-image/slice-command.ts
 var DECIMAL_INTEGER2 = /^\d+$/;
 var HELP_AFTER4 = `
 Usage:
@@ -148074,14 +148464,6 @@ function registerSliceImageCommand(program2) {
   });
 }
 
-// src/commands/register-chatroom-role-command.ts
-function registerChatroomRoleCommand(program2, config) {
-  program2.command(config.name).description(config.description).requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role (e.g., planner, builder)").action(async (options) => {
-    await config.maybeRequireAuth();
-    await config.run(options.chatroomId, { role: options.role });
-  });
-}
-
 // src/utils/multi-value-option.ts
 function collectMultiValueOption(value, previous) {
   return previous ? [...previous, value] : [value];
@@ -148717,4 +149099,4 @@ program2.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program2.parse();
 
-//# debugId=E840D0ACF405C0D664756E2164756E21
+//# debugId=DB5E1205262551F864756E2164756E21