@marlinjai/studio-mcp 0.4.0 → 0.5.0

package/dist/cli.js

@@ -95,7 +95,11 @@ function apiMessageFromBody(body, fallback) {
     if (typeof o.error === "string" && o.error.length > 0) {
       const detail = typeof o.message === "string" ? o.message : "";
       const adds = detail.length > 0 && !o.error.includes(detail) && !detail.includes(o.error);
-      const headline = adds ? `${o.error}: ${detail}` : o.error;
+      let headline = adds ? `${o.error}: ${detail}` : o.error;
+      const hint = typeof o.hint === "string" ? o.hint.trim() : "";
+      if (hint.length > 0 && !headline.includes(hint)) headline = `${headline}${/[.!?]$/.test(headline) ? "" : "."} ${hint}`;
+      const code2 = typeof o.code === "string" ? o.code.trim() : "";
+      if (code2.length > 0 && !headline.includes(code2)) headline = `${headline} (code: ${code2})`;
       const quota = quotaDetail(o);
       return quota ? `${headline} (${quota})` : headline;
     }
@@ -155,6 +159,14 @@ var StudioClient = class {
     return this.json("GET", "/api/v1/projects");
   }
   // ── Generation jobs ──
+  /**
+   * One image job. `brandSlug` is optional: without it the image is generated
+   * with no brand. A `brandSlug` or `characterSlug` the key's company cannot
+   * use is refused with 404 `input_not_found` before anything is spent (since
+   * 2026-10-11; it used to generate without the brand). `projectId` chooses the
+   * project; without it the job lands in the project named after the brand, or
+   * in `default`.
+   */
   generate(body) {
     return this.json("POST", "/api/generate", { json: body });
   }
@@ -443,7 +455,124 @@ function studio3dCreditsToUsd(credits) {
   return Math.round(credits * STUDIO3D_USD_PER_CREDIT * 1e3) / 1e3;
 }
 var FAL_MESHY_RIG_USD = 0.2;
+var veo = (tier, label) => {
+  const slug2 = tier ? `veo-3-1-${tier}` : "veo-3-1";
+  return {
+    kind: "video",
+    id: `route/${slug2}`,
+    label: `${label} (KIE, fal fallback)`,
+    primary: `kie/${slug2}`,
+    fallback: { start: `fal/${slug2}-image-to-video`, startAndEnd: `fal/${slug2}-first-last-frame` }
+  };
+};
+var image = (slug2, label, defaultTier) => ({
+  kind: "image",
+  id: `route/${slug2}`,
+  label: `${label} (KIE, fal fallback)`,
+  primary: `kie/${slug2}`,
+  fallback: `fal/${slug2}`,
+  defaultTier
+});
+var ROUTES = [
+  veo("lite", "Veo 3.1 Lite"),
+  veo("fast", "Veo 3.1 Fast"),
+  veo("", "Veo 3.1"),
+  {
+    kind: "video",
+    id: "route/grok-imagine",
+    label: "Grok Imagine (KIE, fal fallback)",
+    primary: "kie/grok-imagine-image-to-video",
+    fallback: { start: "fal/grok-imagine-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/grok-imagine-1-5",
+    label: "Grok Imagine 1.5 (KIE, fal fallback)",
+    primary: "kie/grok-imagine-1-5-image-to-video",
+    fallback: { start: "fal/grok-imagine-1-5-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/kling-2-5-turbo-pro",
+    label: "Kling 2.5 Turbo Pro (KIE, fal fallback)",
+    primary: "kie/kling-v2-5-turbo-pro-image-to-video",
+    fallback: { start: "fal/kling-v2-5-image-to-video" },
+    // fal needs an aspect ratio (16:9, 9:16 or 1:1) and KIE takes none, so a
+    // fallback would crop a start frame of another shape. The ratio comes from
+    // the start frame once that is built (decision 7 of the plan).
+    noFallbackYet: "fal renders Kling 2.5 at a set aspect ratio (16:9, 9:16 or 1:1) and KIE takes none, so a fallback could crop the start frame. Pin the fal Kling 2.5 entry to choose the ratio yourself."
+  },
+  {
+    kind: "video",
+    id: "route/kling-2-6",
+    label: "Kling 2.6 (KIE, fal fallback)",
+    primary: "kie/kling-2-6-image-to-video",
+    fallback: { start: "fal/kling-2-6-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/kling-o3",
+    label: "Kling O3 (KIE, fal fallback)",
+    primary: "kie/kling-o3-image-to-video",
+    // fal sells Kling O3 as tiers and takes no resolution. Its schema (read
+    // 2026-10-10) declares length, audio and the frames but states no output
+    // size, so Standard for 720p and Pro for 1080p follows Kling's own tier
+    // naming and is still to be confirmed by measuring a rendered clip.
+    fallback: {
+      byResolution: {
+        "720p": "fal/kling-o3-standard-image-to-video",
+        "1080p": "fal/kling-o3-pro-image-to-video"
+      },
+      label: "fal renders Kling O3 at 720p (Standard) or 1080p (Pro)"
+    }
+  },
+  {
+    kind: "video",
+    id: "route/seedance-2-0",
+    label: "Seedance 2.0 (KIE, fal fallback)",
+    primary: "kie/seedance-2-0-image-to-video",
+    fallback: { start: "fal/seedance-2-0-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/seedance-2-5",
+    label: "Seedance 2.5 (KIE, fal fallback)",
+    primary: "kie/seedance-2-5-image-to-video",
+    fallback: { start: "fal/seedance-2-5-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/wan-3-0",
+    label: "Wan 3.0 (KIE, fal fallback)",
+    primary: "kie/wan-3-0-image-to-video",
+    fallback: { start: "fal/wan-3-0-image-to-video" }
+  },
+  image("nano-banana-2", "Nano Banana 2", "1K"),
+  image("nano-banana-2-edit", "Nano Banana 2 Edit", "1K"),
+  image("nano-banana-pro", "Nano Banana Pro", "1K"),
+  image("nano-banana-pro-edit", "Nano Banana Pro Edit", "1K"),
+  image("seedream-5-lite", "Seedream 5 Lite", "2K"),
+  image("seedream-5-lite-edit", "Seedream 5 Lite Edit", "2K"),
+  image("seedream-5-pro", "Seedream 5 Pro", "1K"),
+  image("seedream-5-pro-edit", "Seedream 5 Pro Edit", "1K")
+];
+var MODEL_ROUTES = Object.fromEntries(ROUTES.map((r) => [r.id, r]));
+function getRoute(modelId) {
+  return modelId ? MODEL_ROUTES[modelId] : void 0;
+}
 var MODEL_CATALOG = [
+  // LIST PRICES (`listPrice`, pricing plan of 2026-10-10). Every KIE entry
+  // names where the official list price of its requests is found, because KIE
+  // is the reseller route that sells below list and the price floor needs the
+  // figure. The rule: the model owner's own published price where the catalog
+  // records one (Google's Veo price, billed unchanged by the OpenRouter
+  // entries; Vertex AI's Imagen 4 Fast price), else the fal entry for the same
+  // upstream model. `unrecorded` means neither exists in this catalog, and the
+  // floor then does not apply: Seedream V4, MiniMax H3 and Gemini Omni Flash
+  // have no fal entry, Kling O3 on KIE does not say whether it is fal's
+  // Standard or Pro tier, Suno has no per-song list price, and the Claude
+  // entries bill per token. Entries of every other provider carry no
+  // reference: their route bills the list price itself.
   // ── 3D AI Studio: 3D generation ────────────────────────────────────────
   // `credits` is what the model's DEFAULT request bills (the options its
   // builder sends when a node sets none), priced by providers/studio3d/
@@ -540,6 +669,7 @@ var MODEL_CATALOG = [
     label: "Nano Banana 2 (KIE)",
     description: "Google Gemini 3.1 Flash Image via KIE. $0.04 at 1K, $0.06 at 2K, $0.09 at 4K. Kept as fallback aggregator path; default flipped to fal/nano-banana-2 in 2026-06-04 fal slice.",
     cost: { usd: 0.04, usdByResolution: { "1K": 0.04, "2K": 0.06, "4K": 0.09 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-2" },
     capabilities: { resolutions: ["1K", "2K", "4K"] }
   },
   {
@@ -552,6 +682,7 @@ var MODEL_CATALOG = [
     label: "Imagen 4 Fast (KIE)",
     description: "Google Imagen 4 Fast via KIE. No price advantage vs Vertex direct. No IP indemnity. Vertex AI lists Imagen 4 Fast at $0.02 per image (2026-09-27), which matches the estimate; the KIE price itself is still unmeasured.",
     cost: { usd: 0.02 },
+    listPrice: { source: "owner", usd: 0.02 },
     capabilities: { resolutions: [] }
   },
   {
@@ -561,11 +692,15 @@ var MODEL_CATALOG = [
     task: "text-to-image",
     label: "Seedream V4 (KIE)",
     description: "ByteDance Seedream V4 via KIE. Stylized output not available on Vertex. No IP indemnity.",
-    cost: { usd: 0.0175 }
+    cost: { usd: 0.0175 },
+    listPrice: { source: "unrecorded" }
   },
   // ── KIE.ai: newer image models, the cheaper route (price feed 2026-09-23) ─
   // Billed from the credits KIE reports on each task. KIE offers no data
-  // processing agreement, so real-person uploads belong on the fal entries.
+  // processing agreement. Decided 2026-09-23 (Q5 C of the routing plan,
+  // docs/plans/2026-09-26-kie-first-fal-fallback.md): the automatic routes try
+  // KIE first for everything, a recorded risk; pinning the fal entry of a model
+  // is how a job with a real person's photo is kept off KIE.
   {
     id: "kie/nano-banana-2-edit",
     provider: "kie",
@@ -574,6 +709,7 @@ var MODEL_CATALOG = [
     label: "Nano Banana 2 Edit (KIE)",
     description: "Nano Banana 2 instruction edit via KIE with up to 8 reference images, half the fal price: $0.04 at 1K, $0.06 at 2K, $0.09 at 4K.",
     cost: { usd: 0.04, usdByResolution: { "1K": 0.04, "2K": 0.06, "4K": 0.09 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-2-edit" },
     capabilities: { resolutions: ["1K", "2K", "4K"], needsImageInput: true, maxInputImages: 8 }
   },
   {
@@ -584,6 +720,7 @@ var MODEL_CATALOG = [
     label: "Nano Banana Pro (KIE)",
     description: "Google Gemini 3 Pro Image via KIE: stronger on complex scenes, text in images and new characters than Nano Banana 2 (a relighting edit showed no difference on 2026-09-23). $0.09 at 1K or 2K, $0.12 at 4K (fal: $0.15, $0.30).",
     cost: { usd: 0.09, usdByResolution: { "1K": 0.09, "2K": 0.09, "4K": 0.12 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-pro" },
     capabilities: { resolutions: ["1K", "2K", "4K"], maxInputImages: 0 }
   },
   {
@@ -594,6 +731,7 @@ var MODEL_CATALOG = [
     label: "Nano Banana Pro Edit (KIE)",
     description: "Nano Banana Pro instruction edit via KIE with up to 8 reference images. $0.09 at 1K or 2K, $0.12 at 4K (fal: $0.15, $0.30).",
     cost: { usd: 0.09, usdByResolution: { "1K": 0.09, "2K": 0.09, "4K": 0.12 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-pro-edit" },
     capabilities: { resolutions: ["1K", "2K", "4K"], needsImageInput: true, maxInputImages: 8 }
   },
   {
@@ -604,6 +742,7 @@ var MODEL_CATALOG = [
     label: "Seedream 5 Lite (KIE)",
     description: "ByteDance Seedream 5 Lite via KIE, 2K or 4K. $0.0275 per image (fal: $0.035).",
     cost: { usd: 0.0275 },
+    listPrice: { source: "fal", model: "fal/seedream-5-lite" },
     capabilities: { resolutions: ["2K", "4K"], maxInputImages: 0 }
   },
   {
@@ -614,6 +753,7 @@ var MODEL_CATALOG = [
     label: "Seedream 5 Lite Edit (KIE)",
     description: "ByteDance Seedream 5 Lite image-to-image via KIE, up to 10 reference images, 2K or 4K. $0.0275 per image (fal: $0.035).",
     cost: { usd: 0.0275 },
+    listPrice: { source: "fal", model: "fal/seedream-5-lite-edit" },
     capabilities: { resolutions: ["2K", "4K"], needsImageInput: true, maxInputImages: 10 }
   },
   {
@@ -624,6 +764,7 @@ var MODEL_CATALOG = [
     label: "Seedream 5 Pro (KIE)",
     description: "ByteDance Seedream 5 Pro via KIE, 1K or 2K. $0.035 at 1K, $0.07 at 2K (fal: $0.0675 to $0.135).",
     cost: { usd: 0.035, usdByResolution: { "1K": 0.035, "2K": 0.07 } },
+    listPrice: { source: "fal", model: "fal/seedream-5-pro" },
     capabilities: { resolutions: ["1K", "2K"], maxInputImages: 0 }
   },
   {
@@ -634,6 +775,7 @@ var MODEL_CATALOG = [
     label: "Seedream 5 Pro Edit (KIE)",
     description: "ByteDance Seedream 5 Pro image-to-image via KIE, up to 10 reference images, 1K or 2K. $0.035 at 1K, $0.07 at 2K, plus $0.0025 per extra reference.",
     cost: { usd: 0.035, usdByResolution: { "1K": 0.035, "2K": 0.07 } },
+    listPrice: { source: "fal", model: "fal/seedream-5-pro-edit" },
     capabilities: { resolutions: ["1K", "2K"], needsImageInput: true, maxInputImages: 10 }
   },
   // ── fal.ai: image gen ─────────────────────────────────────────────────
@@ -928,8 +1070,11 @@ var MODEL_CATALOG = [
   // ── KIE.ai video: the cheaper route to the same upstream models ──────────
   // Async via KIE's Veo and createTask APIs (providers/kie-video.ts). 20 to 85%
   // below fal (KIE price feed, 2026-09-23). KIE offers no data processing
-  // agreement, so real-person uploads belong on fal. Anchors are the model's
-  // default clip at 720p (Kling: its fixed size). KIE docs vetted 2026-09-23.
+  // agreement. Decided 2026-09-23 (Q5 C of the routing plan): the automatic
+  // routes try KIE first for everything, a recorded risk; pinning the fal
+  // entry of a model is how a job with a real person's photo is kept off KIE.
+  // Anchors are the model's default clip at 720p (Kling: its fixed size). KIE
+  // docs vetted 2026-09-23.
   {
     id: "kie/veo-3-1-lite",
     provider: "kie",
@@ -938,6 +1083,7 @@ var MODEL_CATALOG = [
     label: "Veo 3.1 Lite (KIE)",
     description: "Google Veo 3.1 Lite via KIE. A start frame, or a start and an end frame; 4, 6 or 8 s; 720p, 1080p or 4K; always with audio. Accepted a minted character's photoreal stills on 2026-09-23. Priced per clip: $0.15 at 720p, $0.175 at 1080p, $0.75 at 4K (fal: $0.24 silent, $0.40 with audio, for 8 s at 720p). KIE's Auto aspect letterboxes, so pick 16:9 or 9:16.",
     cost: { usd: 0.15 },
+    listPrice: { source: "owner", model: "openrouter/veo-3-1-lite" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -948,6 +1094,7 @@ var MODEL_CATALOG = [
     label: "Veo 3.1 Fast (KIE)",
     description: "Google Veo 3.1 Fast via KIE. A start frame, or a start and an end frame; 4, 6 or 8 s; 720p, 1080p or 4K; always with audio. Accepted a minted character's photoreal stills on 2026-09-23. Priced per clip: $0.30 at 720p, $0.325 at 1080p, $0.90 at 4K (fal: $1.20 with audio for 8 s). Pick 16:9 or 9:16.",
     cost: { usd: 0.3 },
+    listPrice: { source: "owner", model: "openrouter/veo-3-1-fast" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -958,6 +1105,7 @@ var MODEL_CATALOG = [
     label: "Veo 3.1 (KIE)",
     description: "Google Veo 3.1 (quality tier) via KIE. A start frame, or a start and an end frame; 4, 6 or 8 s; 720p, 1080p or 4K; always with audio. Same upstream model as the tested Lite and Fast tiers. Priced per clip: $1.25 at 720p, $1.275 at 1080p, $1.85 at 4K (fal: $3.20 with audio).",
     cost: { usd: 1.25 },
+    listPrice: { source: "owner", model: "openrouter/veo-3-1" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   // ── OpenRouter video: Google Veo 3.1 at Google's own prices ───────────────
@@ -1004,6 +1152,7 @@ var MODEL_CATALOG = [
     label: "Grok Imagine (KIE)",
     description: "xAI Grok Imagine via KIE. A start frame, 6 to 30 s, 480p, 720p or 1080p, with audio. Accepted a minted character's photoreal stills on 2026-09-23. $0.012 per second at 480p, $0.0225 at 720p, $0.04 at 1080p (fal: $0.07 at 720p). No end frame.",
     cost: { usd: 0.135 },
+    listPrice: { source: "fal", model: "fal/grok-imagine-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1 }
   },
   {
@@ -1014,6 +1163,7 @@ var MODEL_CATALOG = [
     label: "Grok Imagine 1.5 (KIE, preview)",
     description: "xAI Grok Imagine 1.5 preview via KIE. A start frame, 1 to 15 s, 480p or 720p. Not yet tested with a minted character. $0.012 per second at 480p, $0.0225 at 720p (fal: $0.14 at 720p). No end frame.",
     cost: { usd: 0.18 },
+    listPrice: { source: "fal", model: "fal/grok-imagine-1-5-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1 }
   },
   {
@@ -1024,6 +1174,7 @@ var MODEL_CATALOG = [
     label: "Kling 2.5 Turbo Pro (KIE)",
     description: "Kuaishou Kling 2.5 Turbo Pro via KIE. A start frame and an optional end frame, 5 or 10 s, fixed size. The fal route accepted minted characters; this KIE route is not yet tested with a minted character. $0.21 for 5 s, $0.42 for 10 s (fal: $0.35 for 5 s).",
     cost: { usd: 0.21 },
+    listPrice: { source: "fal", model: "fal/kling-v2-5-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1034,6 +1185,7 @@ var MODEL_CATALOG = [
     label: "Kling 2.6 (KIE)",
     description: "Kuaishou Kling 2.6 via KIE. A start frame, 5 or 10 s, fixed size, silent unless the job sets generateAudio. Not yet tested with a minted character. $0.275 for 5 s silent, $0.55 with sound, 10 s double (fal: $0.35 or $0.70).",
     cost: { usd: 0.275 },
+    listPrice: { source: "fal", model: "fal/kling-2-6-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1 }
   },
   {
@@ -1045,6 +1197,7 @@ var MODEL_CATALOG = [
     refusesPhotorealPeople: true,
     description: "ByteDance Seedance 2.0 via KIE. A start frame and an optional end frame, 4 to 15 s, 480p to 4K. Seedance 2.0 refuses photoreal people, generated ones included: on fal it refused them in every mode (observed 2026-09-23). The refusal comes from the moderation of the model itself, so this route carries the same caution; the KIE route itself has not been run with a person. $0.095 per second at 480p, $0.205 at 720p, $0.51 at 1080p, $1.04 at 4K (fal: about $0.30 at 720p).",
     cost: { usd: 1.025 },
+    listPrice: { source: "fal", model: "fal/seedance-2-0-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1056,6 +1209,7 @@ var MODEL_CATALOG = [
     refusesPhotorealPeople: true,
     description: "ByteDance Seedance 2.5 via KIE. A start frame and an optional end frame, 4 to 30 s, 480p to 1080p. Seedance 2.5 refuses photoreal people, generated ones included: on fal it refused them in every mode (observed 2026-08-21 and 2026-09-23). The refusal comes from the moderation of the model itself, so this route carries the same caution; the KIE route itself has not been run with a person. $0.14 per second at 480p, $0.315 at 720p, $0.79 at 1080p.",
     cost: { usd: 1.575 },
+    listPrice: { source: "fal", model: "fal/seedance-2-5-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1066,6 +1220,7 @@ var MODEL_CATALOG = [
     label: "Wan 3.0 (KIE)",
     description: "Alibaba Wan 3.0 via KIE (hosted only, no downloadable weights). A start frame and an optional end frame, 2 to 30 s, 480p, 720p or 1080p, audio included. Accepted a minted character's photoreal stills on 2026-09-24. $0.04 per second at 480p, $0.08 at 720p, $0.16 at 1080p (fal and Alibaba: $0.10 at 720p).",
     cost: { usd: 0.4 },
+    listPrice: { source: "fal", model: "fal/wan-3-0-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1076,6 +1231,7 @@ var MODEL_CATALOG = [
     label: "MiniMax H3 (KIE)",
     description: "MiniMax H3 via KIE. A start frame and an optional end frame, 4 to 15 s, 768p (the 720p setting) or 2K (the 1080p setting). Accepted a minted character's photoreal stills on 2026-09-24. Its open weights exclude the EU by license; this is KIE's hosted service. $0.04 per second at 768p, $0.065 at 2K.",
     cost: { usd: 0.24 },
+    listPrice: { source: "unrecorded" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1086,6 +1242,7 @@ var MODEL_CATALOG = [
     label: "Gemini Omni 1.1 Flash (KIE)",
     description: "Google Gemini Omni 1.1 Flash via KIE, first-and-last-frame mode. A start frame and an optional end frame, 4, 6, 8 or 10 s, 720p to 4K, 16:9 or 9:16. KIE refuses registered characters in this mode, so identity comes from the frames alone. Accepted a minted character's photoreal stills on 2026-09-24 (set 9:16 for a portrait still: it defaults to 16:9 and crops). $0.315 for 4 s up to $0.63 for 10 s at 720p or 1080p, $0.735 to $1.05 at 4K. No fal equivalent.",
     cost: { usd: 0.525 },
+    listPrice: { source: "unrecorded" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1096,6 +1253,7 @@ var MODEL_CATALOG = [
     label: "Kling O3 (KIE)",
     description: "Kuaishou Kling O3 (KIE calls it Kling 3.0 Omni) via KIE. A start frame and an optional end frame, 3 to 15 s, 720p to 4K in the start frame's shape, silent unless the job sets generateAudio. Accepted a minted character's photoreal stills on 2026-09-24. $0.07 per second at 720p, $0.09 at 1080p, $0.335 at 4K; with sound $0.10 and $0.135.",
     cost: { usd: 0.35 },
+    listPrice: { source: "unrecorded" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -1414,6 +1572,7 @@ var MODEL_CATALOG = [
     label: "Suno V5 (KIE)",
     description: "Suno V5 music generation via KIE. Text-to-music with or without lyrics; ~4 min cap per generation. Default text-to-audio. No IP indemnity (KIE aggregator). KIE's site now features Suno v5.5 and no longer lists a V5 price (checked 2026-09-27), so the $0.04 is an unverified hint.",
     cost: { usd: 0.04 },
+    listPrice: { source: "unrecorded" },
     isDefault: true
   },
   // ── audio: voice via ElevenLabs (B2) ───────────────────────────────────
@@ -1462,6 +1621,7 @@ var MODEL_CATALOG = [
     label: "Claude Sonnet 4.5 (KIE)",
     description: "Anthropic Claude Sonnet 4.5 via KIE (Anthropic Messages API at a lower rate). Default LLM director: prompt improvement + shot descriptions. Cost billed per token; catalog usd is a hint.",
     cost: { usd: 0.01 },
+    listPrice: { source: "unrecorded" },
     isDefault: true
   },
   {
@@ -1471,7 +1631,8 @@ var MODEL_CATALOG = [
     task: "text-generation",
     label: "Claude Opus 4.5 (KIE)",
     description: "Anthropic Claude Opus 4.5 via KIE. Higher quality, higher cost; use for harder director reasoning. Cost billed per token; catalog usd is a hint.",
-    cost: { usd: 0.05 }
+    cost: { usd: 0.05 },
+    listPrice: { source: "unrecorded" }
   },
   {
     id: "openrouter/claude-sonnet-4-6",
@@ -1536,8 +1697,26 @@ var MODEL_CATALOG = [
     description: "Vertex AI direct, newest flash variant. Global region. Preview status."
   }
 ];
+var routeEntries = /* @__PURE__ */ new Map();
+function routeEntry(id) {
+  const cached = routeEntries.get(id);
+  if (cached) return cached;
+  const route = getRoute(id);
+  const primary = route ? MODEL_CATALOG.find((m) => m.id === route.primary) : void 0;
+  if (!route || !primary) return void 0;
+  const entry = {
+    ...primary,
+    // A route is never the default of its task (that is slice 3's switch).
+    isDefault: void 0,
+    id: route.id,
+    label: route.label,
+    description: `Runs on KIE first and, when KIE fails on its side, again on fal with the same settings. ${primary.description ?? ""}`.trim()
+  };
+  routeEntries.set(id, entry);
+  return entry;
+}
 function tryGetModel(id) {
-  return MODEL_CATALOG.find((m) => m.id === id);
+  return MODEL_CATALOG.find((m) => m.id === id) ?? routeEntry(id);
 }
 var ROWS = [
   [0, "Idle", "DailyActions", "Idle"],
@@ -2465,7 +2644,10 @@ var VIDEO_UNSUPPORTED_PARAMS = {
   ...Object.fromEntries(KLING_O3_I2V_ENDPOINTS.map((e) => [e, ["resolution", "aspectRatio", "seed", "negativePrompt"]])),
   ...Object.fromEntries(LTX_25_I2V_ENDPOINTS.map((e) => [e, ["seed", "negativePrompt"]]))
 };
-var perSecond = (rates) => (s, r) => (rates[r] ?? 0) * s;
+var perSecond = (rates) => (s, r) => {
+  const rate = rates[r];
+  return rate === void 0 ? void 0 : rate * s;
+};
 function veoSpec(model, label, perClip) {
   return {
     family: "veo",
@@ -2479,7 +2661,7 @@ function veoSpec(model, label, perClip) {
     audioSwitch: false,
     defaultAudio: true,
     // KIE prices Veo per clip whatever its length, and always renders audio.
-    price: (_s, r) => perClip[r] ?? 0,
+    price: (_s, r) => perClip[r],
     build: (i) => ({
       prompt: i.prompt,
       model,
@@ -2686,7 +2868,7 @@ var KIE_VIDEO_SPECS = {
     audioSwitch: false,
     defaultAudio: false,
     // Priced per clip by length; 4K carries a surcharge.
-    price: (s, r) => (r === "4k" ? { 4: 0.735, 6: 0.84, 8: 0.945, 10: 1.05 } : { 4: 0.315, 6: 0.42, 8: 0.525, 10: 0.63 })[s] ?? 0,
+    price: (s, r) => (r === "4k" ? { 4: 0.735, 6: 0.84, 8: 0.945, 10: 1.05 } : { 4: 0.315, 6: 0.42, 8: 0.525, 10: 0.63 })[s],
     // The first-and-last-frame mode: KIE refuses it combined with registered
     // characters, reference images, audio or video, so none are sent.
     build: (i) => ({
@@ -2712,7 +2894,7 @@ var KIE_VIDEO_SPECS = {
     audioSwitch: true,
     defaultAudio: false,
     // With-audio rates from KIE's price feed, the higher of its two listings.
-    price: (s, r, audio) => ((audio ? { "720p": 0.1, "1080p": 0.135, "4k": 0.335 } : { "720p": 0.07, "1080p": 0.09, "4k": 0.335 })[r] ?? 0) * s,
+    price: (s, r, audio) => perSecond(audio ? { "720p": 0.1, "1080p": 0.135, "4k": 0.335 } : { "720p": 0.07, "1080p": 0.09, "4k": 0.335 })(s, r),
     build: (i) => ({
       prompt: i.prompt,
       image_urls: i.end ? [i.start, i.end] : [i.start],
@@ -3154,7 +3336,124 @@ function imageResolutionTier(value) {
       return null;
   }
 }
+var veo2 = (tier, label) => {
+  const slug2 = tier ? `veo-3-1-${tier}` : "veo-3-1";
+  return {
+    kind: "video",
+    id: `route/${slug2}`,
+    label: `${label} (KIE, fal fallback)`,
+    primary: `kie/${slug2}`,
+    fallback: { start: `fal/${slug2}-image-to-video`, startAndEnd: `fal/${slug2}-first-last-frame` }
+  };
+};
+var image2 = (slug2, label, defaultTier) => ({
+  kind: "image",
+  id: `route/${slug2}`,
+  label: `${label} (KIE, fal fallback)`,
+  primary: `kie/${slug2}`,
+  fallback: `fal/${slug2}`,
+  defaultTier
+});
+var ROUTES2 = [
+  veo2("lite", "Veo 3.1 Lite"),
+  veo2("fast", "Veo 3.1 Fast"),
+  veo2("", "Veo 3.1"),
+  {
+    kind: "video",
+    id: "route/grok-imagine",
+    label: "Grok Imagine (KIE, fal fallback)",
+    primary: "kie/grok-imagine-image-to-video",
+    fallback: { start: "fal/grok-imagine-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/grok-imagine-1-5",
+    label: "Grok Imagine 1.5 (KIE, fal fallback)",
+    primary: "kie/grok-imagine-1-5-image-to-video",
+    fallback: { start: "fal/grok-imagine-1-5-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/kling-2-5-turbo-pro",
+    label: "Kling 2.5 Turbo Pro (KIE, fal fallback)",
+    primary: "kie/kling-v2-5-turbo-pro-image-to-video",
+    fallback: { start: "fal/kling-v2-5-image-to-video" },
+    // fal needs an aspect ratio (16:9, 9:16 or 1:1) and KIE takes none, so a
+    // fallback would crop a start frame of another shape. The ratio comes from
+    // the start frame once that is built (decision 7 of the plan).
+    noFallbackYet: "fal renders Kling 2.5 at a set aspect ratio (16:9, 9:16 or 1:1) and KIE takes none, so a fallback could crop the start frame. Pin the fal Kling 2.5 entry to choose the ratio yourself."
+  },
+  {
+    kind: "video",
+    id: "route/kling-2-6",
+    label: "Kling 2.6 (KIE, fal fallback)",
+    primary: "kie/kling-2-6-image-to-video",
+    fallback: { start: "fal/kling-2-6-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/kling-o3",
+    label: "Kling O3 (KIE, fal fallback)",
+    primary: "kie/kling-o3-image-to-video",
+    // fal sells Kling O3 as tiers and takes no resolution. Its schema (read
+    // 2026-10-10) declares length, audio and the frames but states no output
+    // size, so Standard for 720p and Pro for 1080p follows Kling's own tier
+    // naming and is still to be confirmed by measuring a rendered clip.
+    fallback: {
+      byResolution: {
+        "720p": "fal/kling-o3-standard-image-to-video",
+        "1080p": "fal/kling-o3-pro-image-to-video"
+      },
+      label: "fal renders Kling O3 at 720p (Standard) or 1080p (Pro)"
+    }
+  },
+  {
+    kind: "video",
+    id: "route/seedance-2-0",
+    label: "Seedance 2.0 (KIE, fal fallback)",
+    primary: "kie/seedance-2-0-image-to-video",
+    fallback: { start: "fal/seedance-2-0-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/seedance-2-5",
+    label: "Seedance 2.5 (KIE, fal fallback)",
+    primary: "kie/seedance-2-5-image-to-video",
+    fallback: { start: "fal/seedance-2-5-image-to-video" }
+  },
+  {
+    kind: "video",
+    id: "route/wan-3-0",
+    label: "Wan 3.0 (KIE, fal fallback)",
+    primary: "kie/wan-3-0-image-to-video",
+    fallback: { start: "fal/wan-3-0-image-to-video" }
+  },
+  image2("nano-banana-2", "Nano Banana 2", "1K"),
+  image2("nano-banana-2-edit", "Nano Banana 2 Edit", "1K"),
+  image2("nano-banana-pro", "Nano Banana Pro", "1K"),
+  image2("nano-banana-pro-edit", "Nano Banana Pro Edit", "1K"),
+  image2("seedream-5-lite", "Seedream 5 Lite", "2K"),
+  image2("seedream-5-lite-edit", "Seedream 5 Lite Edit", "2K"),
+  image2("seedream-5-pro", "Seedream 5 Pro", "1K"),
+  image2("seedream-5-pro-edit", "Seedream 5 Pro Edit", "1K")
+];
+var MODEL_ROUTES2 = Object.fromEntries(ROUTES2.map((r) => [r.id, r]));
+function getRoute2(modelId) {
+  return modelId ? MODEL_ROUTES2[modelId] : void 0;
+}
 var MODEL_CATALOG2 = [
+  // LIST PRICES (`listPrice`, pricing plan of 2026-10-10). Every KIE entry
+  // names where the official list price of its requests is found, because KIE
+  // is the reseller route that sells below list and the price floor needs the
+  // figure. The rule: the model owner's own published price where the catalog
+  // records one (Google's Veo price, billed unchanged by the OpenRouter
+  // entries; Vertex AI's Imagen 4 Fast price), else the fal entry for the same
+  // upstream model. `unrecorded` means neither exists in this catalog, and the
+  // floor then does not apply: Seedream V4, MiniMax H3 and Gemini Omni Flash
+  // have no fal entry, Kling O3 on KIE does not say whether it is fal's
+  // Standard or Pro tier, Suno has no per-song list price, and the Claude
+  // entries bill per token. Entries of every other provider carry no
+  // reference: their route bills the list price itself.
   // ── 3D AI Studio: 3D generation ────────────────────────────────────────
   // `credits` is what the model's DEFAULT request bills (the options its
   // builder sends when a node sets none), priced by providers/studio3d/
@@ -3251,6 +3550,7 @@ var MODEL_CATALOG2 = [
     label: "Nano Banana 2 (KIE)",
     description: "Google Gemini 3.1 Flash Image via KIE. $0.04 at 1K, $0.06 at 2K, $0.09 at 4K. Kept as fallback aggregator path; default flipped to fal/nano-banana-2 in 2026-06-04 fal slice.",
     cost: { usd: 0.04, usdByResolution: { "1K": 0.04, "2K": 0.06, "4K": 0.09 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-2" },
     capabilities: { resolutions: ["1K", "2K", "4K"] }
   },
   {
@@ -3263,6 +3563,7 @@ var MODEL_CATALOG2 = [
     label: "Imagen 4 Fast (KIE)",
     description: "Google Imagen 4 Fast via KIE. No price advantage vs Vertex direct. No IP indemnity. Vertex AI lists Imagen 4 Fast at $0.02 per image (2026-09-27), which matches the estimate; the KIE price itself is still unmeasured.",
     cost: { usd: 0.02 },
+    listPrice: { source: "owner", usd: 0.02 },
     capabilities: { resolutions: [] }
   },
   {
@@ -3272,11 +3573,15 @@ var MODEL_CATALOG2 = [
     task: "text-to-image",
     label: "Seedream V4 (KIE)",
     description: "ByteDance Seedream V4 via KIE. Stylized output not available on Vertex. No IP indemnity.",
-    cost: { usd: 0.0175 }
+    cost: { usd: 0.0175 },
+    listPrice: { source: "unrecorded" }
   },
   // ── KIE.ai: newer image models, the cheaper route (price feed 2026-09-23) ─
   // Billed from the credits KIE reports on each task. KIE offers no data
-  // processing agreement, so real-person uploads belong on the fal entries.
+  // processing agreement. Decided 2026-09-23 (Q5 C of the routing plan,
+  // docs/plans/2026-09-26-kie-first-fal-fallback.md): the automatic routes try
+  // KIE first for everything, a recorded risk; pinning the fal entry of a model
+  // is how a job with a real person's photo is kept off KIE.
   {
     id: "kie/nano-banana-2-edit",
     provider: "kie",
@@ -3285,6 +3590,7 @@ var MODEL_CATALOG2 = [
     label: "Nano Banana 2 Edit (KIE)",
     description: "Nano Banana 2 instruction edit via KIE with up to 8 reference images, half the fal price: $0.04 at 1K, $0.06 at 2K, $0.09 at 4K.",
     cost: { usd: 0.04, usdByResolution: { "1K": 0.04, "2K": 0.06, "4K": 0.09 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-2-edit" },
     capabilities: { resolutions: ["1K", "2K", "4K"], needsImageInput: true, maxInputImages: 8 }
   },
   {
@@ -3295,6 +3601,7 @@ var MODEL_CATALOG2 = [
     label: "Nano Banana Pro (KIE)",
     description: "Google Gemini 3 Pro Image via KIE: stronger on complex scenes, text in images and new characters than Nano Banana 2 (a relighting edit showed no difference on 2026-09-23). $0.09 at 1K or 2K, $0.12 at 4K (fal: $0.15, $0.30).",
     cost: { usd: 0.09, usdByResolution: { "1K": 0.09, "2K": 0.09, "4K": 0.12 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-pro" },
     capabilities: { resolutions: ["1K", "2K", "4K"], maxInputImages: 0 }
   },
   {
@@ -3305,6 +3612,7 @@ var MODEL_CATALOG2 = [
     label: "Nano Banana Pro Edit (KIE)",
     description: "Nano Banana Pro instruction edit via KIE with up to 8 reference images. $0.09 at 1K or 2K, $0.12 at 4K (fal: $0.15, $0.30).",
     cost: { usd: 0.09, usdByResolution: { "1K": 0.09, "2K": 0.09, "4K": 0.12 } },
+    listPrice: { source: "fal", model: "fal/nano-banana-pro-edit" },
     capabilities: { resolutions: ["1K", "2K", "4K"], needsImageInput: true, maxInputImages: 8 }
   },
   {
@@ -3315,6 +3623,7 @@ var MODEL_CATALOG2 = [
     label: "Seedream 5 Lite (KIE)",
     description: "ByteDance Seedream 5 Lite via KIE, 2K or 4K. $0.0275 per image (fal: $0.035).",
     cost: { usd: 0.0275 },
+    listPrice: { source: "fal", model: "fal/seedream-5-lite" },
     capabilities: { resolutions: ["2K", "4K"], maxInputImages: 0 }
   },
   {
@@ -3325,6 +3634,7 @@ var MODEL_CATALOG2 = [
     label: "Seedream 5 Lite Edit (KIE)",
     description: "ByteDance Seedream 5 Lite image-to-image via KIE, up to 10 reference images, 2K or 4K. $0.0275 per image (fal: $0.035).",
     cost: { usd: 0.0275 },
+    listPrice: { source: "fal", model: "fal/seedream-5-lite-edit" },
     capabilities: { resolutions: ["2K", "4K"], needsImageInput: true, maxInputImages: 10 }
   },
   {
@@ -3335,6 +3645,7 @@ var MODEL_CATALOG2 = [
     label: "Seedream 5 Pro (KIE)",
     description: "ByteDance Seedream 5 Pro via KIE, 1K or 2K. $0.035 at 1K, $0.07 at 2K (fal: $0.0675 to $0.135).",
     cost: { usd: 0.035, usdByResolution: { "1K": 0.035, "2K": 0.07 } },
+    listPrice: { source: "fal", model: "fal/seedream-5-pro" },
     capabilities: { resolutions: ["1K", "2K"], maxInputImages: 0 }
   },
   {
@@ -3345,6 +3656,7 @@ var MODEL_CATALOG2 = [
     label: "Seedream 5 Pro Edit (KIE)",
     description: "ByteDance Seedream 5 Pro image-to-image via KIE, up to 10 reference images, 1K or 2K. $0.035 at 1K, $0.07 at 2K, plus $0.0025 per extra reference.",
     cost: { usd: 0.035, usdByResolution: { "1K": 0.035, "2K": 0.07 } },
+    listPrice: { source: "fal", model: "fal/seedream-5-pro-edit" },
     capabilities: { resolutions: ["1K", "2K"], needsImageInput: true, maxInputImages: 10 }
   },
   // ── fal.ai: image gen ─────────────────────────────────────────────────
@@ -3639,8 +3951,11 @@ var MODEL_CATALOG2 = [
   // ── KIE.ai video: the cheaper route to the same upstream models ──────────
   // Async via KIE's Veo and createTask APIs (providers/kie-video.ts). 20 to 85%
   // below fal (KIE price feed, 2026-09-23). KIE offers no data processing
-  // agreement, so real-person uploads belong on fal. Anchors are the model's
-  // default clip at 720p (Kling: its fixed size). KIE docs vetted 2026-09-23.
+  // agreement. Decided 2026-09-23 (Q5 C of the routing plan): the automatic
+  // routes try KIE first for everything, a recorded risk; pinning the fal
+  // entry of a model is how a job with a real person's photo is kept off KIE.
+  // Anchors are the model's default clip at 720p (Kling: its fixed size). KIE
+  // docs vetted 2026-09-23.
   {
     id: "kie/veo-3-1-lite",
     provider: "kie",
@@ -3649,6 +3964,7 @@ var MODEL_CATALOG2 = [
     label: "Veo 3.1 Lite (KIE)",
     description: "Google Veo 3.1 Lite via KIE. A start frame, or a start and an end frame; 4, 6 or 8 s; 720p, 1080p or 4K; always with audio. Accepted a minted character's photoreal stills on 2026-09-23. Priced per clip: $0.15 at 720p, $0.175 at 1080p, $0.75 at 4K (fal: $0.24 silent, $0.40 with audio, for 8 s at 720p). KIE's Auto aspect letterboxes, so pick 16:9 or 9:16.",
     cost: { usd: 0.15 },
+    listPrice: { source: "owner", model: "openrouter/veo-3-1-lite" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3659,6 +3975,7 @@ var MODEL_CATALOG2 = [
     label: "Veo 3.1 Fast (KIE)",
     description: "Google Veo 3.1 Fast via KIE. A start frame, or a start and an end frame; 4, 6 or 8 s; 720p, 1080p or 4K; always with audio. Accepted a minted character's photoreal stills on 2026-09-23. Priced per clip: $0.30 at 720p, $0.325 at 1080p, $0.90 at 4K (fal: $1.20 with audio for 8 s). Pick 16:9 or 9:16.",
     cost: { usd: 0.3 },
+    listPrice: { source: "owner", model: "openrouter/veo-3-1-fast" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3669,6 +3986,7 @@ var MODEL_CATALOG2 = [
     label: "Veo 3.1 (KIE)",
     description: "Google Veo 3.1 (quality tier) via KIE. A start frame, or a start and an end frame; 4, 6 or 8 s; 720p, 1080p or 4K; always with audio. Same upstream model as the tested Lite and Fast tiers. Priced per clip: $1.25 at 720p, $1.275 at 1080p, $1.85 at 4K (fal: $3.20 with audio).",
     cost: { usd: 1.25 },
+    listPrice: { source: "owner", model: "openrouter/veo-3-1" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   // ── OpenRouter video: Google Veo 3.1 at Google's own prices ───────────────
@@ -3715,6 +4033,7 @@ var MODEL_CATALOG2 = [
     label: "Grok Imagine (KIE)",
     description: "xAI Grok Imagine via KIE. A start frame, 6 to 30 s, 480p, 720p or 1080p, with audio. Accepted a minted character's photoreal stills on 2026-09-23. $0.012 per second at 480p, $0.0225 at 720p, $0.04 at 1080p (fal: $0.07 at 720p). No end frame.",
     cost: { usd: 0.135 },
+    listPrice: { source: "fal", model: "fal/grok-imagine-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1 }
   },
   {
@@ -3725,6 +4044,7 @@ var MODEL_CATALOG2 = [
     label: "Grok Imagine 1.5 (KIE, preview)",
     description: "xAI Grok Imagine 1.5 preview via KIE. A start frame, 1 to 15 s, 480p or 720p. Not yet tested with a minted character. $0.012 per second at 480p, $0.0225 at 720p (fal: $0.14 at 720p). No end frame.",
     cost: { usd: 0.18 },
+    listPrice: { source: "fal", model: "fal/grok-imagine-1-5-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1 }
   },
   {
@@ -3735,6 +4055,7 @@ var MODEL_CATALOG2 = [
     label: "Kling 2.5 Turbo Pro (KIE)",
     description: "Kuaishou Kling 2.5 Turbo Pro via KIE. A start frame and an optional end frame, 5 or 10 s, fixed size. The fal route accepted minted characters; this KIE route is not yet tested with a minted character. $0.21 for 5 s, $0.42 for 10 s (fal: $0.35 for 5 s).",
     cost: { usd: 0.21 },
+    listPrice: { source: "fal", model: "fal/kling-v2-5-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3745,6 +4066,7 @@ var MODEL_CATALOG2 = [
     label: "Kling 2.6 (KIE)",
     description: "Kuaishou Kling 2.6 via KIE. A start frame, 5 or 10 s, fixed size, silent unless the job sets generateAudio. Not yet tested with a minted character. $0.275 for 5 s silent, $0.55 with sound, 10 s double (fal: $0.35 or $0.70).",
     cost: { usd: 0.275 },
+    listPrice: { source: "fal", model: "fal/kling-2-6-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1 }
   },
   {
@@ -3756,6 +4078,7 @@ var MODEL_CATALOG2 = [
     refusesPhotorealPeople: true,
     description: "ByteDance Seedance 2.0 via KIE. A start frame and an optional end frame, 4 to 15 s, 480p to 4K. Seedance 2.0 refuses photoreal people, generated ones included: on fal it refused them in every mode (observed 2026-09-23). The refusal comes from the moderation of the model itself, so this route carries the same caution; the KIE route itself has not been run with a person. $0.095 per second at 480p, $0.205 at 720p, $0.51 at 1080p, $1.04 at 4K (fal: about $0.30 at 720p).",
     cost: { usd: 1.025 },
+    listPrice: { source: "fal", model: "fal/seedance-2-0-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3767,6 +4090,7 @@ var MODEL_CATALOG2 = [
     refusesPhotorealPeople: true,
     description: "ByteDance Seedance 2.5 via KIE. A start frame and an optional end frame, 4 to 30 s, 480p to 1080p. Seedance 2.5 refuses photoreal people, generated ones included: on fal it refused them in every mode (observed 2026-08-21 and 2026-09-23). The refusal comes from the moderation of the model itself, so this route carries the same caution; the KIE route itself has not been run with a person. $0.14 per second at 480p, $0.315 at 720p, $0.79 at 1080p.",
     cost: { usd: 1.575 },
+    listPrice: { source: "fal", model: "fal/seedance-2-5-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3777,6 +4101,7 @@ var MODEL_CATALOG2 = [
     label: "Wan 3.0 (KIE)",
     description: "Alibaba Wan 3.0 via KIE (hosted only, no downloadable weights). A start frame and an optional end frame, 2 to 30 s, 480p, 720p or 1080p, audio included. Accepted a minted character's photoreal stills on 2026-09-24. $0.04 per second at 480p, $0.08 at 720p, $0.16 at 1080p (fal and Alibaba: $0.10 at 720p).",
     cost: { usd: 0.4 },
+    listPrice: { source: "fal", model: "fal/wan-3-0-image-to-video" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3787,6 +4112,7 @@ var MODEL_CATALOG2 = [
     label: "MiniMax H3 (KIE)",
     description: "MiniMax H3 via KIE. A start frame and an optional end frame, 4 to 15 s, 768p (the 720p setting) or 2K (the 1080p setting). Accepted a minted character's photoreal stills on 2026-09-24. Its open weights exclude the EU by license; this is KIE's hosted service. $0.04 per second at 768p, $0.065 at 2K.",
     cost: { usd: 0.24 },
+    listPrice: { source: "unrecorded" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3797,6 +4123,7 @@ var MODEL_CATALOG2 = [
     label: "Gemini Omni 1.1 Flash (KIE)",
     description: "Google Gemini Omni 1.1 Flash via KIE, first-and-last-frame mode. A start frame and an optional end frame, 4, 6, 8 or 10 s, 720p to 4K, 16:9 or 9:16. KIE refuses registered characters in this mode, so identity comes from the frames alone. Accepted a minted character's photoreal stills on 2026-09-24 (set 9:16 for a portrait still: it defaults to 16:9 and crops). $0.315 for 4 s up to $0.63 for 10 s at 720p or 1080p, $0.735 to $1.05 at 4K. No fal equivalent.",
     cost: { usd: 0.525 },
+    listPrice: { source: "unrecorded" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -3807,6 +4134,7 @@ var MODEL_CATALOG2 = [
     label: "Kling O3 (KIE)",
     description: "Kuaishou Kling O3 (KIE calls it Kling 3.0 Omni) via KIE. A start frame and an optional end frame, 3 to 15 s, 720p to 4K in the start frame's shape, silent unless the job sets generateAudio. Accepted a minted character's photoreal stills on 2026-09-24. $0.07 per second at 720p, $0.09 at 1080p, $0.335 at 4K; with sound $0.10 and $0.135.",
     cost: { usd: 0.35 },
+    listPrice: { source: "unrecorded" },
     capabilities: { needsImageInput: true, maxInputImages: 1, acceptsEndFrame: true }
   },
   {
@@ -4125,6 +4453,7 @@ var MODEL_CATALOG2 = [
     label: "Suno V5 (KIE)",
     description: "Suno V5 music generation via KIE. Text-to-music with or without lyrics; ~4 min cap per generation. Default text-to-audio. No IP indemnity (KIE aggregator). KIE's site now features Suno v5.5 and no longer lists a V5 price (checked 2026-09-27), so the $0.04 is an unverified hint.",
     cost: { usd: 0.04 },
+    listPrice: { source: "unrecorded" },
     isDefault: true
   },
   // ── audio: voice via ElevenLabs (B2) ───────────────────────────────────
@@ -4173,6 +4502,7 @@ var MODEL_CATALOG2 = [
     label: "Claude Sonnet 4.5 (KIE)",
     description: "Anthropic Claude Sonnet 4.5 via KIE (Anthropic Messages API at a lower rate). Default LLM director: prompt improvement + shot descriptions. Cost billed per token; catalog usd is a hint.",
     cost: { usd: 0.01 },
+    listPrice: { source: "unrecorded" },
     isDefault: true
   },
   {
@@ -4182,7 +4512,8 @@ var MODEL_CATALOG2 = [
     task: "text-generation",
     label: "Claude Opus 4.5 (KIE)",
     description: "Anthropic Claude Opus 4.5 via KIE. Higher quality, higher cost; use for harder director reasoning. Cost billed per token; catalog usd is a hint.",
-    cost: { usd: 0.05 }
+    cost: { usd: 0.05 },
+    listPrice: { source: "unrecorded" }
   },
   {
     id: "openrouter/claude-sonnet-4-6",
@@ -4247,8 +4578,26 @@ var MODEL_CATALOG2 = [
     description: "Vertex AI direct, newest flash variant. Global region. Preview status."
   }
 ];
+var routeEntries2 = /* @__PURE__ */ new Map();
+function routeEntry2(id) {
+  const cached = routeEntries2.get(id);
+  if (cached) return cached;
+  const route = getRoute2(id);
+  const primary = route ? MODEL_CATALOG2.find((m) => m.id === route.primary) : void 0;
+  if (!route || !primary) return void 0;
+  const entry = {
+    ...primary,
+    // A route is never the default of its task (that is slice 3's switch).
+    isDefault: void 0,
+    id: route.id,
+    label: route.label,
+    description: `Runs on KIE first and, when KIE fails on its side, again on fal with the same settings. ${primary.description ?? ""}`.trim()
+  };
+  routeEntries2.set(id, entry);
+  return entry;
+}
 function tryGetModel2(id) {
-  return MODEL_CATALOG2.find((m) => m.id === id);
+  return MODEL_CATALOG2.find((m) => m.id === id) ?? routeEntry2(id);
 }
 function supportedResolutions(model) {
   const declared = model?.capabilities?.resolutions;
@@ -5895,7 +6244,7 @@ function nodeUrl(res, nodeId) {
 }
 var studioListProjects = defineTool({
   name: "studio_list_projects",
-  description: 'List the Studio projects visible to this API key (id, slug, name). A projectId is required by studio_run_workflow, studio_mint_character and studio_replace_character_in_video; call this first to find it (the usual one is slug "default").',
+  description: 'List the Studio projects visible to this API key (id, slug, name). A projectId is required by studio_run_workflow, studio_run_published, studio_mint_character, studio_rig_3d and studio_replace_character_in_video; call this first to find it (the usual one is slug "default"). It is optional on studio_generate_image and studio_generate_3d, where it chooses the project the result is filed in.',
   inputSchema: {},
   annotations: { readOnlyHint: true },
   handler: async (_args, ctx) => {
@@ -5905,17 +6254,26 @@ var studioListProjects = defineTool({
 });
 var studioGenerateImage = defineTool({
   name: "studio_generate_image",
-  description: "Generate one image with a brand's style applied (the Studio injects the brand's style prefix and reference images server-side). Optionally pin a minted character so its identity references are injected too. Submits a job and, when wait=true (default), polls until it finishes and returns the signed image URL and cost in USD. With wait=false it returns the jobId immediately for studio_get_job. Typical cost ~$0.04 per image.",
+  description: 'Generate an image from a prompt. A brand is optional: pass brandSlug to have the Studio apply that brand\'s style prefix and reference images server-side, or leave it out for an image without a brand. Optionally pin a character (characterSlug) so its identity references are injected too. A brandSlug or characterSlug that names nothing your company can use is refused before anything is spent (404, code input_not_found), and the error text says what to do next: act on it or relay it as written. The image is filed in projectId when given, otherwise in the project named after the brand (created on first use), otherwise in the project "default". Submits a job and, when wait=true (default), polls until it finishes and returns the signed image URL and costUsd (the provider cost of the job; what a company on prepaid credits pays for it is at least that cost times its rate, see studio_get_usage). With wait=false it returns the jobId immediately for studio_get_job. candidateCount asks for up to four candidates, but some models render one image regardless of the count: the result carries `candidates: { requested, rendered, mayRender? }`, and a `notice` to pass on to the user whenever fewer images will be made than were asked for. Typical cost ~$0.04 per image.',
   inputSchema: {
-    brandSlug: slug.describe('Brand to apply (e.g. "lola-stories"). Required by the API.'),
-    brandMode: z8.string().optional().describe('Optional brand mode (e.g. "illustration"); modes are defined per brand.'),
-    prompt: z8.string().min(1).describe("What to generate. The brand style prefix is prepended server-side."),
-    characterSlug: slug.optional().describe("Optional minted character whose identity references are injected."),
+    brandSlug: slug.optional().describe(
+      "Optional. The slug of a brand of your company (create one with studio_create_brand). Omit it to generate without a brand. A slug that names no brand of your company is refused with 404 input_not_found; it is never used as a project name."
+    ),
+    brandMode: z8.string().optional().describe('Optional brand mode (e.g. "illustration"); modes are defined per brand. Only meaningful with brandSlug.'),
+    prompt: z8.string().min(1).describe("What to generate. With brandSlug, the brand style prefix is prepended server-side."),
+    characterSlug: slug.optional().describe(
+      "Optional character whose identity references are injected: one of your company's, or one another company shared (see studio_list_characters). A slug your company cannot use is refused with 404 input_not_found."
+    ),
+    projectId: z8.string().min(1).optional().describe(
+      'Optional project to file the image under (an id from studio_list_projects; it must be a project of your company, anything else is a 404). Omit it to use the project named after brandSlug, or "default" when there is no brand.'
+    ),
     model: z8.string().optional().describe('Image model id (e.g. "kie/nano-banana-2", "fal/nano-banana-2"). Omit for the Studio default.'),
     aspectRatio: z8.string().optional().describe('Aspect ratio such as "1:1", "16:9", "3:4".'),
     imageSize: z8.string().optional().describe('Provider size hint, e.g. "1K", "2K".'),
     seed: z8.number().int().optional(),
-    candidateCount: z8.number().int().min(1).max(4).optional().describe("Number of candidates (1 to 4)."),
+    candidateCount: z8.number().int().min(1).max(4).optional().describe(
+      "Number of candidates (1 to 4). Not every model takes a count: most KIE image models render one image whatever is asked, and a `route/...` model runs on KIE first, so expect one there too (its fal fallback may render up to four). The result carries `candidates: { requested, rendered, mayRender? }`, plus a `notice` whenever fewer will be rendered than were asked for; only rendered images are charged."
+    ),
     wait: z8.boolean().default(true).describe("Poll until the job finishes (default true)."),
     waitSeconds
   },
@@ -5927,19 +6285,24 @@ var studioGenerateImage = defineTool({
     if (args.seed !== void 0) settings.seed = args.seed;
     if (args.candidateCount !== void 0) settings.candidateCount = args.candidateCount;
     const submitted = await ctx.client.generate({
-      brandSlug: args.brandSlug,
+      ...args.brandSlug ? { brandSlug: args.brandSlug } : {},
       ...args.brandMode ? { brandMode: args.brandMode } : {},
       prompt: args.prompt,
       ...args.characterSlug ? { characterSlug: args.characterSlug } : {},
+      ...args.projectId ? { projectId: args.projectId } : {},
       ...Object.keys(settings).length > 0 ? { settings } : {}
     });
-    if (!args.wait) return { jobId: submitted.jobId, kind: submitted.kind, status: "queued" };
+    const plan = {
+      ...submitted.candidates ? { candidates: submitted.candidates } : {},
+      ...typeof submitted.notice === "string" && submitted.notice.length > 0 ? { notice: submitted.notice } : {}
+    };
+    if (!args.wait) return { jobId: submitted.jobId, kind: submitted.kind, status: "queued", ...plan };
     const done = await waitForJob(ctx.client, submitted.jobId, pollOpts(ctx, args.waitSeconds));
     const out = projectJob(done);
     if (done.job.status !== "succeeded") {
       throw new Error(`Job ${submitted.jobId} ${done.job.status}: ${done.job.errorMessage ?? "no error message from the API"}`);
     }
-    return { ...out, kind: submitted.kind };
+    return { ...out, kind: submitted.kind, ...plan };
   }
 });
 var GENERATE_3D_TASKS = /* @__PURE__ */ new Set(["text-to-3d", "image-to-3d"]);
@@ -6085,7 +6448,7 @@ var studioGetJob = defineTool({
 });
 var studioListCharacters = defineTool({
   name: "studio_list_characters",
-  description: "List all minted characters (slug, name, descriptor prompt, default model). Use a slug with studio_get_character for its reference images, or with studio_generate_image to render that character.",
+  description: "List the characters this API key can use (slug, name, descriptor prompt, default model, shared, owned): the ones its company minted, plus the ones another company shared with everyone (owned: false, usable in generations but read-only). A slug is unique within one company; when your company and a shared character use the same slug, yours is the one listed and used. Use a slug with studio_get_character for its reference images, or with studio_generate_image to render that character.",
   inputSchema: {},
   annotations: { readOnlyHint: true },
   handler: async (_args, ctx) => {
@@ -6095,7 +6458,7 @@ var studioListCharacters = defineTool({
 });
 var studioGetCharacter = defineTool({
   name: "studio_get_character",
-  description: "Fetch one character by slug with its full context: descriptor and negative prompts plus every frozen reference image (category such as face, three-quarter, profile, full-body, close-up, lighting-warm, lighting-cool; freshly signed URL). The full-body or face reference URL is what studio_replace_character_in_video needs as characterImageUrl.",
+  description: "Fetch one character by slug with its full context: descriptor and negative prompts plus every frozen reference image (category such as face, three-quarter, profile, full-body, close-up, lighting-warm, lighting-cool; URL). The full-body or face reference URL is what studio_replace_character_in_video needs as characterImageUrl. For a character your company owns the URL is a direct image URL. For a character another company shared (owned: false) it is a Studio address: pass it unchanged as an image input to any Studio tool and the Studio resolves it when the job runs, but it is not a public image URL, and it stops working the moment the owner stops sharing.",
   inputSchema: { slug },
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
@@ -6110,7 +6473,7 @@ function assertLikenessRightsConfirmed(value) {
 }
 var studioCreateCharacter = defineTool({
   name: "studio_create_character",
-  description: "Create an empty character record (no reference images yet). Prefer studio_mint_character, which generates the 7-view identity sheet and freezes it as references in one call. Use this only when you will upload your own reference images. Requires likenessRightsConfirmed: true, which you may only pass after the human you act for confirmed it for this character. Fails with 409 if the slug exists.",
+  description: "Create an empty character record (no reference images yet). Prefer studio_mint_character, which generates the 7-view identity sheet and freezes it as references in one call. Use this only when you will upload your own reference images. Requires likenessRightsConfirmed: true, which you may only pass after the human you act for confirmed it for this character. Fails with 409 (code slug_taken) only if your own company already has a character with this slug; a slug another company uses is free to take.",
   inputSchema: {
     name: z8.string().min(1).describe('Display name, e.g. "Bruno Hartmann".'),
     slug,
@@ -6202,7 +6565,7 @@ var studioMintCharacter = defineTool({
 });
 var studioCreateBrand = defineTool({
   name: "studio_create_brand",
-  description: "Create a brand (a style preset: name, slug, optional style prefix prepended to every prompt, optional free-text context). Upload reference images afterwards with studio_upload_brand_reference. Fails with 409 if the slug exists.",
+  description: "Create a brand (a style preset: name, slug, optional style prefix prepended to every prompt, optional free-text context). Upload reference images afterwards with studio_upload_brand_reference. Fails with 409 (code slug_taken) only if your own company already has a brand with this slug; a slug another company uses is free to take.",
   inputSchema: {
     name: z8.string().min(1),
     slug,
@@ -6227,7 +6590,7 @@ var studioUploadBrandReference = defineTool({
   name: "studio_upload_brand_reference",
   description: `Upload one reference image to a brand's library from a local file path or an http(s) URL. The Studio converts it to a 512px WebP and injects it into generations under that brand (up to the brand's maxReferenceImages). Category groups references (default "general"); tags and a 1 to 10 quality score are optional.`,
   inputSchema: {
-    brandSlug: slug,
+    brandSlug: slug.describe("The slug of a brand of your company (from studio_create_brand). A slug that names no brand of your company is a 404, and nothing is uploaded."),
     source: z8.string().min(1).describe("Local file path or http(s) URL of an image."),
     category: z8.string().optional().describe('Library category, default "general".'),
     label: z8.string().optional().describe("Optional file name / label."),
@@ -6349,7 +6712,9 @@ var studioReplaceCharacterInVideo = defineTool({
   inputSchema: {
     projectId: z8.string().min(1).describe("Project id from studio_list_projects."),
     sceneFrameUrl: httpUrl.describe("Public or signed URL of ONE frame of the target shot (png/jpg)."),
-    characterSlug: slug.optional().describe("Minted character to insert; its full-body reference (fallback three-quarter, face) is resolved automatically."),
+    characterSlug: slug.optional().describe(
+      "Character to insert: one of your company's, or one another company shared. Its full-body reference (fallback three-quarter, face) is resolved automatically. A slug your company cannot use is a 404 before the run starts, so nothing is spent."
+    ),
     characterReferenceUrl: httpUrl.optional().describe("Explicit character reference image URL (use instead of characterSlug)."),
     endFrameUrl: httpUrl.optional().describe("Optional second approved keyframe for the END of the clip. Switches the video model to Kling (start + end frame) unless videoModel is set explicitly."),
     scope: z8.enum(SWAP_SCOPES).optional().describe("How much of the person to replace. identity (default): face, head and hair from the character, the footage keeps its body. full_body: also the character body proportions; the silhouette changes, so the background behind the old body and every contact point must be re-derived."),
@@ -6422,7 +6787,7 @@ var studioReplaceCharacterInVideo = defineTool({
 });
 var studioGetSpend = defineTool({
   name: "studio_get_spend",
-  description: `Read the spend ledger: total USD and job counts for today, the last 7 days and the last 30 days, plus the most recent paid actions. tzOffsetMinutes is the viewer's Date.getTimezoneOffset() so "today" rolls at local midnight (default UTC).`,
+  description: "Read the spend ledger: total USD and job counts for today, the last 7 days and the last 30 days, plus the most recent paid actions. The amounts are provider cost (each job's costUsd); for a company on prepaid credits, what left its balance is in studio_get_usage (`credits`). tzOffsetMinutes is the viewer's Date.getTimezoneOffset() so \"today\" rolls at local midnight (default UTC).",
   inputSchema: {
     tzOffsetMinutes: z8.number().int().min(-840).max(840).optional()
   },
@@ -6434,7 +6799,7 @@ var studioGetSpend = defineTool({
 });
 var studioGetUsage = defineTool({
   name: "studio_get_usage",
-  description: `Read this key's tenant against its plan (docs/plans/2026-08-21-studio-api-keys-and-quotas.md): month-to-date USD spend and job count, the plan's monthly cap and requests-per-minute limit (null = unlimited), and a per-model breakdown, most expensive first. A company with no plan of its own is held to the default monthly cap (capSource "default", 20 USD unless the operator configured otherwise); only a plan the Lumitra operator set can be unlimited. Call this before a large batch to check remaining budget, or after a 402/429 to see what tripped; a 402 means the monthly limit is reached and only the Lumitra operator can raise it before it resets. Every /api/generate, /api/v1/workflows/run and /api/try-on call carries this key's tenant. usedUsd includes in-flight (not yet settled) job estimates, so it can go DOWN as well as up: a job that later fails releases its estimate.`,
+  description: "Read what limits the company this key belongs to, and what it has used: month-to-date spend (usedUsd, realizedUsd, inFlightEstimatedUsd) and job count at provider cost, the monthly cap (capUsd) and requests-per-minute limit (rpm), null meaning none, and a per-model breakdown, most expensive first. A company on prepaid credits (every new company; a company the Studio already knew keeps the caps it had) has no monthly cap unless the Lumitra operator set one; `credits` says what limits it instead: `balanceUsd` (the prepaid balance), `dailyLimitUsd` (null: none), `usedTodayUsd` (what left the balance today, running jobs included) and `dailyResetsAt` (midnight UTC). Each finished generation is debited from the balance at provider cost times the company's rate (1.50 on pay as you go), or 80 percent of the model's list price where that is higher, so the credit figures are higher than the provider-cost figures beside them. balanceUsd does not yet subtract what is reserved for requests that are still starting or running, so the room for a new request can be smaller than balanceUsd. A company not on credits has `credits` null and is held to its monthly cap (20 USD by default, capSource \"default\", unless the Lumitra operator set a plan). Call this before a large batch to check remaining room, or after a 402 or 429 to see what tripped. The refusal's own error text says which limit it was and what to do, so relay it as written; it also names the code: `credits_exhausted` (the balance does not cover the request: add credits on the Billing page, or wait a few seconds when part of the balance is only reserved), `daily_cap_reached` (on credits a company owner or admin raises the daily limit on the Billing page; it resets at midnight UTC), `monthly_cap_reached` (only the Lumitra operator can raise it) or `velocity_limit_reached` (too many paid requests in a short time: wait as long as the text says). usedUsd includes in-flight (not yet settled) job estimates, so it can go DOWN as well as up: a job that later fails releases its estimate.",
   inputSchema: {},
   annotations: { readOnlyHint: true },
   handler: async (_args, ctx) => {
@@ -6554,7 +6919,7 @@ function registerTools(server, ctx) {
 
 // src/server.ts
 var SERVER_NAME = "lumitra-studio";
-var SERVER_VERSION = "0.4.0";
+var SERVER_VERSION = "0.5.0";
 function createStudioMcpServer(opts = {}) {
   const config = opts.config ?? resolveConfig(opts.env ?? process.env);
   const client = new StudioClient(config, {
@@ -6566,7 +6931,7 @@ function createStudioMcpServer(opts = {}) {
     {
       instructions: [
         "Lumitra Studio: brand-consistent image generation, character minting, workflow runs and the still-swap video recipe over the hosted Studio API.",
-        "Start with studio_list_projects to get a projectId. Every generation costs real money (roughly $0.04 per image, $0.30 per character mint, $0.70 per video take); check studio_get_spend when in doubt.",
+        "Start with studio_list_projects to get a projectId. Every generation costs real money (roughly $0.04 per image, $0.30 per character mint, $0.70 per video take); check studio_get_spend when in doubt, and studio_get_usage for what limits the company (a prepaid credit balance with a daily limit, or a monthly cap). A refusal carries the Studio's own sentence with the next step in it: act on it or relay it as written.",
         "Long jobs: tools wait by default (up to timeoutSeconds, 600 by default) and return ids you can poll with studio_get_job / studio_get_run if they time out.",
         "Authoring a workflow is free and revisioned: studio_workflow_describe for the vocabulary, studio_workflow_create to build one from ops, studio_workflow_apply to change it on top of a baseRevision (a stale_revision result means re-read, rebase, retry), studio_workflow_validate to dry-run before spending, then studio_run_workflow with its savedId.",
         "Workflow hygiene: one deliverable is ONE saved workflow with a node per item, and a refinement of an item (edit, upscale, variation) is a NEW NODE appended to that workflow with studio_workflow_apply (addNode plus a connect from the node it refines, so the earlier generation is its input), then studio_run_workflow with savedId and nodeIds limited to the new node. Never send a fresh inline definition for a follow-up: every listed inline run is saved as its own workflow, which scatters one deliverable across duplicates."