@nodaro/shared 1.9.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/__tests__/credit-identifiers.test.ts

@@ -17,6 +17,8 @@ describe("buildCreditModelIdentifier", () => {
       "seedream-edit",
       "seedream-5-lite",
       "seedream-5-lite-i2i",
+      "seedream-5-pro",
+      "seedream-5-pro-i2i",
     ]
 
     it.each(highQualityProviders)(

package/src/__tests__/image-ref-limit.test.ts

@@ -16,7 +16,9 @@ describe("imageReferenceLimit", () => {
     "flux-2-max": 8,
     "gpt-image-2": 16, // → gpt-image-2-i2i
     "seedream-5-lite": 16, // → seedream-5-lite-i2i
+    "seedream-5-pro": 16, // → seedream-5-pro-i2i
     "nano-banana-2": 4,
+    "nano-banana-2-lite": 10, // schema maxItems (image_urls)
     flux: 4, // → flux-pro-i2i
     "flux-2-klein": 1, // product cap (schema array slices at 5)
     "flux-2-pro": 4, // product cap (BFL schema accepts 8)

package/src/__tests__/llm-models.test.ts

@@ -430,20 +430,27 @@ describe("STRUCTURED_VISION_MODELS", () => {
         "gemini-3.1-pro",
         "claude-sonnet-5",
         "claude-opus-4.8",
+        // responses-format GPTs — KIE text.format json_schema live-verified
+        // 2026-07-14 (text AND vision inputs).
+        "gpt-5.4",
+        "gpt-5.5",
+        "gpt-5.6-luna",
+        "gpt-5.6-terra",
+        "gpt-5.6-sol",
       ].sort(),
     )
   })
 
-  it("includes Anthropic (forced-tool) AND Gemini (response_format) vendors", () => {
+  it("includes Anthropic (forced-tool), Gemini (response_format), and OpenAI (responses text.format) vendors", () => {
     const vendors = new Set(STRUCTURED_VISION_MODELS.map((m) => m.vendor))
     expect(vendors).toContain("anthropic")
     expect(vendors).toContain("google")
+    expect(vendors).toContain("openai")
   })
 
-  it("excludes GPT models — no native structured mode (parse+retry only)", () => {
+  it("excludes chat-completions GPT models — no native structured mode there (parse+retry only)", () => {
     const ids = STRUCTURED_VISION_MODELS.map((m) => m.id)
     expect(ids).not.toContain("gpt-5.2")
-    expect(ids).not.toContain("gpt-5.4")
   })
 
   it("every member is vision-capable and has a structuredOutputMode", () => {

package/src/__tests__/prompt-length-limits.test.ts

@@ -28,6 +28,7 @@ describe("per-model prompt length limits", () => {
   describe("getMaxImagePromptChars", () => {
     it("returns the verified higher caps (provider supports more than 5000)", () => {
       expect(getMaxImagePromptChars("nano-banana-2")).toBe(20000)
+      expect(getMaxImagePromptChars("nano-banana-2-lite")).toBe(20000)
       expect(getMaxImagePromptChars("nano-banana-pro")).toBe(20000)
       expect(getMaxImagePromptChars("gpt-image-2-i2i")).toBe(20000)
     })
@@ -44,6 +45,8 @@ describe("per-model prompt length limits", () => {
     it("falls back to IMAGE_PROMPT_MAX for verified-default + unknown providers", () => {
       expect(getMaxImagePromptChars("flux")).toBe(IMAGE_PROMPT_MAX)
       expect(getMaxImagePromptChars("imagen4")).toBe(IMAGE_PROMPT_MAX)
+      expect(getMaxImagePromptChars("seedream-5-pro")).toBe(IMAGE_PROMPT_MAX) // verified 5000 in KIE schema
+      expect(getMaxImagePromptChars("seedream-5-pro-i2i")).toBe(IMAGE_PROMPT_MAX) // verified 5000 in KIE schema
       expect(getMaxImagePromptChars("grok-i2i")).toBe(IMAGE_PROMPT_MAX) // 390000 doc = sanity-capped
       expect(getMaxImagePromptChars("flux-kontext")).toBe(IMAGE_PROMPT_MAX) // UNVERIFIED
       expect(getMaxImagePromptChars(undefined)).toBe(IMAGE_PROMPT_MAX)

package/src/__tests__/seedance2-continuation-ref.test.ts

@@ -0,0 +1,24 @@
+import { describe, it, expect } from "vitest"
+import {
+  SEEDANCE_2_CONTINUATION_REF_SEC,
+  SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC,
+  SEEDANCE_2_EXTEND_STITCH,
+} from "../model-constants.js"
+
+/** KIE hard-rejects r2v reference videos below the floor: "the parameter
+ *  video duration (seconds) specified in the request must be greater than or
+ *  equal to 1.8 for model dreamina-seedance-2-0-fast in r2v" (2026-07-13,
+ *  job dbf95612 — the original 1.0s tails made every generate-video-pro
+ *  continuation segment fail deterministically). Everything this platform
+ *  sends as a Seedance-2 video reference cuts SEEDANCE_2_CONTINUATION_REF_SEC
+ *  seconds; do NOT "optimize" it back below the floor. The private-plugin
+ *  twin constants (nodaro-cloud-plugins chain.ts TAIL_SEC / bridge-math.ts
+ *  MIN_REF) are guarded by that repo's r2v-ref-floor.test.ts — keep in sync. */
+describe("seedance-2 continuation-reference floor (do not regress)", () => {
+  it("the platform's continuation-ref length clears KIE's r2v minimum", () => {
+    expect(SEEDANCE_2_CONTINUATION_REF_SEC).toBeGreaterThanOrEqual(SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC)
+  })
+  it("the extend node's tail IS the shared continuation-ref length (single source)", () => {
+    expect(SEEDANCE_2_EXTEND_STITCH.referenceTailSeconds).toBe(SEEDANCE_2_CONTINUATION_REF_SEC)
+  })
+})

package/src/__tests__/video-analysis-pricing.test.ts

@@ -5,13 +5,16 @@ import {
   pickVideoAnalysisBucket, buildVideoAnalysisCreditId, bucketSecondsFromCreditId,
   videoAnalysisNumWindows,
 } from "../video-analysis-pricing.js"
-import { VIDEO_ANALYSIS_LLM_MODELS } from "../llm-models.js"
+import {
+  VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_ORDER,
+  DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_ANALYSIS_MODEL, resolveVideoAnalysisModel,
+} from "../llm-models.js"
 
 // The measured-rate constants and the $-derived `videoAnalysisBucketCredits`
-// formula moved to backend/src/lib/pricing/video-analysis-cost.ts (S5) — its
-// tests (including the worked-example bucket-credit values and the
-// cross-check against VIDEO_ANALYSIS_BUCKET_CREDITS below) live in
-// backend/src/lib/pricing/__tests__/video-analysis-cost.test.ts. This file
+// formula are PRIVATE, in @nodaroai/cloud-plugins
+// (src/plugins/video-analysis/cost.ts) — its tests (the worked-example
+// bucket-credit values and the cross-check against VIDEO_ANALYSIS_BUCKET_CREDITS
+// below) live in that private package's __tests__/cost.test.ts. This file
 // covers only the NON-monetary duration-bucketing, window-batching, and
 // credit-id-construction logic that stays in the published package.
 
@@ -40,6 +43,26 @@ describe("video-analysis-pricing", () => {
     expect(VIDEO_ANALYSIS_LLM_MODELS).toEqual(["gemini-3-flash", "gemini-3.1-pro"])
   })
 
+  it("tier layer: every tier maps to a real model AND every model is tier-reachable (no vendor leak)", () => {
+    // Adding a video-analysis model without a tier would silently leave it
+    // unreachable / unnamed — this fails until a tier decision is made.
+    const tierTargets = Object.values(VIDEO_ANALYSIS_TIERS)
+    for (const m of tierTargets) expect(VIDEO_ANALYSIS_LLM_MODELS).toContain(m)
+    for (const m of VIDEO_ANALYSIS_LLM_MODELS) expect(tierTargets).toContain(m)
+    expect(new Set(VIDEO_ANALYSIS_TIER_ORDER)).toEqual(new Set(Object.keys(VIDEO_ANALYSIS_TIERS)))
+  })
+
+  it("resolveVideoAnalysisModel: tier → model, raw model passthrough, default pro on empty/unknown", () => {
+    expect(DEFAULT_VIDEO_ANALYSIS_TIER).toBe("pro")
+    expect(DEFAULT_VIDEO_ANALYSIS_MODEL).toBe("gemini-3.1-pro")
+    expect(resolveVideoAnalysisModel("pro")).toBe("gemini-3.1-pro")
+    expect(resolveVideoAnalysisModel("fast")).toBe("gemini-3-flash")
+    expect(resolveVideoAnalysisModel("gemini-3-flash")).toBe("gemini-3-flash") // raw passthrough
+    expect(resolveVideoAnalysisModel(undefined)).toBe("gemini-3.1-pro") // default → pro
+    expect(resolveVideoAnalysisModel("")).toBe("gemini-3.1-pro")
+    expect(resolveVideoAnalysisModel("nonsense")).toBe("gemini-3.1-pro") // unknown → default, never throws
+  })
+
   // Full drift-detection against the live $-formula lives in
   // backend/src/lib/pricing/__tests__/video-analysis-cost.test.ts (this
   // package cannot see the formula post-S5). This is a lightweight shape

package/src/__tests__/video-analysis.test.ts

@@ -7,7 +7,7 @@ import {
 } from "../video-analysis.js"
 
 const slot: EntitySlot = { slotId: "hero", label: "Protagonist", source: "wired-character", role: "person", description: "tan man, mustache, black tee" }
-const baseScene = { startSec: 0, endSec: 4, label: "Hook", shotType: "Medium Close-Up", camera: "slow push-in", visual: "{slot:hero} juggles a ball", audio: { mode: "speech" as const, content: "As a kid…", voice: "male, warm" } }
+const baseScene = { startSec: 0, endSec: 4, label: "Hook", shotType: "Medium Close-Up", camera: "slow push-in", visual: "{slot:hero} juggles a ball", audio: [{ mode: "speech" as const, content: "As a kid…", voice: "male, warm" }] }
 
 describe("windowAnalysisSchema", () => {
   it("accepts a zero-scene window (quiet footage is a VALID result)", () => {

package/src/index.ts

@@ -19,6 +19,7 @@ export {
   MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER,
   getMaxImagePromptChars,
   PROMPT_HARD_CEILING,
+  LLM_TEXT_INPUT_MAX,
   MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER,
   getMaxVideoPromptChars,
   NEGATIVE_PROMPT_MAX,
@@ -95,6 +96,8 @@ export {
   SEEDANCE_2_PROVIDERS,
   SEEDANCE_2_REF_LIMITS,
   SEEDANCE_2_EXTEND_STITCH,
+  SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC,
+  SEEDANCE_2_CONTINUATION_REF_SEC,
   NATIVE_ADAPTIVE_ASPECT,
   VIDEO_REF_LIMITS_BY_PROVIDER,
   VIDEO_PROVIDERS_REQUIRING_IMAGE,
@@ -250,6 +253,14 @@ export {
   LLM_MODEL_IDS,
   STRUCTURED_VISION_MODELS,
   VIDEO_ANALYSIS_LLM_MODELS,
+  VIDEO_ANALYSIS_TIERS,
+  type VideoAnalysisTier,
+  VIDEO_ANALYSIS_TIER_ORDER,
+  DEFAULT_VIDEO_ANALYSIS_TIER,
+  DEFAULT_VIDEO_ANALYSIS_MODEL,
+  VIDEO_ANALYSIS_TIER_LABELS,
+  isVideoAnalysisTier,
+  resolveVideoAnalysisModel,
   LLM_FEATURE_DEFAULTS,
   LLM_MODALITY_CAPS,
   LLM_REASONING_EFFORTS,

package/src/llm-models.ts

@@ -37,14 +37,18 @@ export interface LlmModelDef {
   maxOutputTokens: number
   /**
    * How this model can be forced into schema-valid structured output.
-   * - "anthropic-tool"       → direct Anthropic SDK forced tool_choice (guaranteed).
-   * - "kie-response-format"  → KIE chat-completions `response_format: json_schema`
-   *                            (verified enforced for Gemini via KIE).
-   * - undefined              → no native structured mode (GPT-via-KIE doesn't honor
-   *                            response_format); callers fall back to parse + retry.
+   * - "anthropic-tool"          → forced tool_choice on the Claude wire (direct SDK
+   *                               guaranteed; KIE's proxy re-serializes the tool call
+   *                               as a `<tool_calls>` text tag — decoded in llm-client).
+   * - "kie-response-format"     → KIE chat-completions `response_format: json_schema`
+   *                               (verified enforced for Gemini via KIE).
+   * - "responses-json-schema"   → KIE codex/v1/responses `text.format: json_schema`
+   *                               (live-verified 2026-07-14 for gpt-5.4/5.5 and the
+   *                               whole GPT-5.6 family, text AND vision inputs).
+   * - undefined                 → no native mode; callers fall back to parse + retry.
    * Capability-driven so `llmCompleteStructured` never hardcodes provider ids.
    */
-  structuredOutputMode?: "anthropic-tool" | "kie-response-format"
+  structuredOutputMode?: "anthropic-tool" | "kie-response-format" | "responses-json-schema"
   /** If set, fallback to direct Anthropic SDK with this model ID when KIE.ai fails */
   directFallbackModel?: string
   /** Effort levels this model accepts (ascending). Absent/empty = no effort lever, picker hidden. */
@@ -142,6 +146,7 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
     kieFormat: "responses",
     kieSlugOrModel: "gpt-5-4",
     vendor: "openai",
+    structuredOutputMode: "responses-json-schema",
     supportsImages: true,
     maxOutputTokens: 16384,
     reasoningEfforts: ["low", "medium", "high"],
@@ -154,6 +159,7 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
     kieFormat: "responses",
     kieSlugOrModel: "gpt-5-5",
     vendor: "openai",
+    structuredOutputMode: "responses-json-schema",
     supportsImages: true,
     maxOutputTokens: 16384,
     reasoningEfforts: ["none", "low", "medium", "high", "xhigh", "max"],
@@ -167,6 +173,7 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
     kieFormat: "responses",
     kieSlugOrModel: "gpt-5-6-luna",
     vendor: "openai",
+    structuredOutputMode: "responses-json-schema",
     supportsImages: true,
     maxOutputTokens: 16384,
     reasoningEfforts: ["none", "low", "medium", "high", "xhigh", "max"],
@@ -180,6 +187,7 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
     kieFormat: "responses",
     kieSlugOrModel: "gpt-5-6-terra",
     vendor: "openai",
+    structuredOutputMode: "responses-json-schema",
     supportsImages: true,
     maxOutputTokens: 16384,
     reasoningEfforts: ["none", "low", "medium", "high", "xhigh", "max"],
@@ -193,6 +201,7 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
     kieFormat: "responses",
     kieSlugOrModel: "gpt-5-6-sol",
     vendor: "openai",
+    structuredOutputMode: "responses-json-schema",
     supportsImages: true,
     maxOutputTokens: 16384,
     reasoningEfforts: ["none", "low", "medium", "high", "xhigh", "max"],
@@ -238,9 +247,10 @@ export const LLM_MODEL_IDS = LLM_MODELS.map((m) => m.id)
 /** Vision models that can return GUARANTEED structured output — the
  *  describe-to-picker analyzer forces a schema over an image, so its model
  *  pickers AND the backend route gate offer exactly these: Anthropic (forced
- *  tool) + Gemini (KIE `response_format`). GPT-via-KIE has no native structured
- *  mode (parse+retry only), so it's excluded. Single source of truth so the
- *  picker, the config panel, and the route gate can't drift. */
+ *  tool), Gemini (KIE `response_format`), and GPT responses-format models
+ *  (KIE `text.format` json_schema — vision+schema live-verified 2026-07-14).
+ *  Single source of truth so the picker, the config panel, and the route gate
+ *  can't drift. */
 export const STRUCTURED_VISION_MODELS = LLM_MODELS.filter(
   (m) => m.supportsImages && m.structuredOutputMode != null,
 )
@@ -376,3 +386,36 @@ export function resolveLlmCreditId(feature: string, body: unknown): string {
 export const VIDEO_ANALYSIS_LLM_MODELS: string[] = LLM_MODELS
   .filter((m) => getLlmModalityCaps(m.id).video && getLlmModalityCaps(m.id).audio)
   .map((m) => m.id)
+
+/**
+ * Video-analysis quality TIERS — the ONLY analyzer identifiers exposed to users
+ * (API, UI, docs). Each maps to an internal analysis model; the underlying
+ * vendor/model name is never surfaced. Default is `pro`. The guard test
+ * (video-analysis-pricing.test.ts) asserts every tier target is a real
+ * VIDEO_ANALYSIS_LLM_MODELS member AND every such model is reachable by a tier,
+ * so adding a video model forces a tier decision instead of silently leaking.
+ */
+export const VIDEO_ANALYSIS_TIERS = { fast: "gemini-3-flash", pro: "gemini-3.1-pro" } as const
+export type VideoAnalysisTier = keyof typeof VIDEO_ANALYSIS_TIERS
+/** UI/listing order — recommended (pro) first. */
+export const VIDEO_ANALYSIS_TIER_ORDER = ["pro", "fast"] as const
+export const DEFAULT_VIDEO_ANALYSIS_TIER: VideoAnalysisTier = "pro"
+export const DEFAULT_VIDEO_ANALYSIS_MODEL: string = VIDEO_ANALYSIS_TIERS[DEFAULT_VIDEO_ANALYSIS_TIER]
+/** Neutral, vendor-free display labels for the UI. */
+export const VIDEO_ANALYSIS_TIER_LABELS: Record<VideoAnalysisTier, string> = { fast: "Fast", pro: "Pro" }
+
+export function isVideoAnalysisTier(v: string): v is VideoAnalysisTier {
+  return Object.prototype.hasOwnProperty.call(VIDEO_ANALYSIS_TIERS, v)
+}
+
+/**
+ * Resolve a user-supplied tier (`"fast"`/`"pro"`) OR a raw internal model id to
+ * the internal analysis model id. Empty/unknown → the default tier's model.
+ * Real model ids pass through (back-compat for existing stored `llmModel`
+ * values); anything else falls back to the default rather than erroring.
+ */
+export function resolveVideoAnalysisModel(input?: string | null): string {
+  if (input && isVideoAnalysisTier(input)) return VIDEO_ANALYSIS_TIERS[input]
+  if (input && VIDEO_ANALYSIS_LLM_MODELS.includes(input)) return input
+  return DEFAULT_VIDEO_ANALYSIS_MODEL
+}

package/src/model-catalog.ts

@@ -146,7 +146,7 @@ export const MODEL_RECOMMENDATIONS: readonly ModelRecommendation[] = [
   { intent: "best for typography / logos / text-heavy", modelIds: ["nano-banana-pro", "gpt-image-2"], note: "Nano Banana Pro for diagrams / complex text; GPT Image 2 for logos and short copy." },
   { intent: "cheapest realistic image", modelIds: ["z-image", "qwen", "imagen4-fast"], note: "Z-Image is the cheapest at 1 credit. Qwen / Imagen4 Fast for slightly higher quality." },
   { intent: "highest fidelity image", modelIds: ["nano-banana-pro", "imagen4-ultra", "flux-flex"], note: "Pick by family preference; all three are premium tiers." },
-  { intent: "image edit / restyle", modelIds: ["flux-kontext", "ideogram-remix", "seedream-5-lite-i2i"], note: "Flux Kontext preserves identity; Ideogram Remix is character-aware; Seedream 5 Lite for instruction-based edits." },
+  { intent: "image edit / restyle", modelIds: ["flux-kontext", "ideogram-remix", "seedream-5-pro-i2i"], note: "Flux Kontext preserves identity; Ideogram Remix is character-aware; Seedream 5 Pro for instruction-based edits (5 Lite is the budget option)." },
   { intent: "highest-resolution image (4K / 8K)", modelIds: ["topaz-image-upscale", "nano-banana-pro", "gpt-image-2"], note: "Generate at native then Topaz upscale for 8K." },
   { intent: "background removal / cutout", modelIds: ["recraft-remove-bg"], note: "1 credit, no prompt needed." },
   // video
@@ -165,6 +165,11 @@ export const MODEL_RECOMMENDATIONS: readonly ModelRecommendation[] = [
 // can consume them. Keep in sync when adding a new ratio set.)
 // =============================================================================
 const NANO_BANANA_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9"] as const
+// Nano Banana 2 Lite only — the model's full documented enum incl. `auto`
+// (native default) and extreme banner ratios (docs.kie.ai/market/google/
+// nano-banana-2-lite). Kept separate so the wider set can't leak to the
+// rest of the family.
+const NANO_BANANA_2_LITE_RATIOS = ["auto", "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9", "4:1", "1:4", "8:1", "1:8"] as const
 // Note: these arrays are synchronized with the frontend's
 // `model-options.ts` constants of the same names. The frontend now imports
 // them via the `getAspectRatioOptions(modelId)` helper; if you update one
@@ -233,6 +238,22 @@ const IMAGE_MODELS: Record<string, ModelCatalogEntry> = {
       { identifier: "nano-banana-2:4K", credits: 5, note: "4K" },
     ],
   },
+  "nano-banana-2-lite": {
+    id: "nano-banana-2-lite",
+    kind: "image",
+    // Same single-id shape as nano-banana-2: optional input images on the one
+    // endpoint (via image_urls, up to 10), so reachable for both t2i and i2i.
+    modes: ["t2i", "i2i"] as const,
+    family: "Google",
+    label: "Nano Banana 2 Lite",
+    series: "Nano Banana",
+    description: "Lightweight Nano Banana 2 (Gemini 3.1 Flash-Lite) — fast, low-cost 1K generation and editing.",
+    useCases: ["realistic", "drafts", "iteration"],
+    features: ["reference-image"],
+    aspectRatios: NANO_BANANA_2_LITE_RATIOS,
+    // 1K only — no resolution lever, flat pricing.
+    pricing: [{ identifier: "nano-banana-2-lite", credits: 2, note: "1K flat" }],
+  },
   "nano-banana-pro": {
     id: "nano-banana-pro",
     kind: "image",
@@ -691,6 +712,40 @@ const IMAGE_MODELS: Record<string, ModelCatalogEntry> = {
       { identifier: "seedream-5-lite-i2i:high", credits: 5, note: "high quality" },
     ],
   },
+  "seedream-5-pro": {
+    id: "seedream-5-pro",
+    kind: "image",
+    modes: ["t2i"] as const,
+    family: "Bytedance",
+    label: "Seedream 5 Pro",
+    series: "Seedream",
+    description: "Flagship Seedream 5 Pro — strongest instruction following and visual reasoning. Basic = 1K, high = 2K.",
+    useCases: ["realistic", "instruction"],
+    features: ["reference-image"],
+    aspectRatios: SEEDREAM_RATIOS,
+    qualities: ["basic", "high"],
+    pricing: [
+      { identifier: "seedream-5-pro", credits: 3, note: "basic / 1K default" },
+      { identifier: "seedream-5-pro:high", credits: 6, note: "high / 2K" },
+    ],
+  },
+  "seedream-5-pro-i2i": {
+    id: "seedream-5-pro-i2i",
+    kind: "image",
+    modes: ["i2i"] as const,
+    family: "Bytedance",
+    label: "Seedream 5 Pro (I2I)",
+    series: "Seedream",
+    description: "Image-to-image with Seedream 5 Pro — multi-reference instruction edits. Basic = 1K, high = 2K.",
+    useCases: ["edit", "instruction"],
+    features: ["reference-image"],
+    aspectRatios: SEEDREAM_RATIOS,
+    qualities: ["basic", "high"],
+    pricing: [
+      { identifier: "seedream-5-pro-i2i", credits: 3, note: "basic / 1K default" },
+      { identifier: "seedream-5-pro-i2i:high", credits: 6, note: "high / 2K" },
+    ],
+  },
 
   // ── Alibaba Qwen ──
   "qwen": {
@@ -1754,10 +1809,10 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     id: "gemini-3-flash-video-analysis",
     kind: "video",
     modes: ["video-analysis"] as const,
-    family: "Google",
-    label: "Video Analysis (Gemini 3 Flash)",
-    series: "Gemini",
-    description: "Analyze a video into a structured shot list (scenes, camera, audio) — fast Gemini tier. Billed per duration bucket.",
+    family: "Nodaro",
+    label: "Video Analysis (Fast)",
+    series: "Video Analysis",
+    description: "Analyze a video into a structured shot list (scenes, camera, audio) — fast, economy tier. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "fast"],
     pricing: [
       { identifier: "video-analysis:gemini-3-flash", credits: 3, note: "10-min ceiling (no duration given)" },
@@ -1771,10 +1826,10 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     id: "gemini-3.1-pro-video-analysis",
     kind: "video",
     modes: ["video-analysis"] as const,
-    family: "Google",
-    label: "Video Analysis (Gemini 3.1 Pro)",
-    series: "Gemini",
-    description: "Analyze a video into a structured shot list (scenes, camera, audio) — high-fidelity Gemini tier. Billed per duration bucket.",
+    family: "Nodaro",
+    label: "Video Analysis (Pro)",
+    series: "Video Analysis",
+    description: "Analyze a video into a structured shot list (scenes, camera, audio) — higher-fidelity, default tier. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "cinematic"],
     pricing: [
       { identifier: "video-analysis:gemini-3.1-pro", credits: 11, note: "10-min ceiling (no duration given)" },

package/src/model-constants.ts

@@ -37,6 +37,7 @@ export const IMAGE_PROMPT_MAX = 5000
 export const MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER: Record<string, number> = {
   // ── higher than the 5000 default ──
   "nano-banana-2": 20000,      // docs.kie.ai/market/google/nano-banana-2
+  "nano-banana-2-lite": 20000, // docs.kie.ai/market/google/nano-banana-2-lite
   "nano-banana-pro": 20000,    // docs.kie.ai/market/google/pro-image-to-image
   "gpt-image-2-i2i": 20000,    // docs.kie.ai/market/gpt/gpt-image-2-image-to-image
   // ── lower than the 5000 default (over-send risk if left at default) ──
@@ -48,7 +49,8 @@ export const MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER: Record<string, number> = {
   "qwen-edit": 2000,           // docs.kie.ai/market/qwen/image-edit
   // verified == 5000 default (no entry needed): imagen4(-fast/-ultra), nano-banana,
   //   nano-banana-edit, flux, flux-flex, gpt-image-2, ideogram-v3/-edit/-remix,
-  //   z-image, grok, qwen-i2i.
+  //   z-image, grok, qwen-i2i, seedream-5-pro, seedream-5-pro-i2i
+  //   (docs.kie.ai/market/seedream/5-pro-text-to-image + 5-pro-image-to-image).
   // grok-i2i: doc states 390000 (78× its t2i sibling) — treated as a KIE schema
   //   typo and left at the 5000 default per the sanity-cap decision.
   // UNVERIFIED (no limit stated in schema) → 5000 default: flux-kontext(-max)
@@ -93,6 +95,18 @@ export const SUNO_TEXT_MAX = 5000
  */
 export const PROMPT_HARD_CEILING = 20000
 
+/**
+ * Ceiling for LLM TEXT-generation node inputs (the "Generate Text"/llm-chat node
+ * + AI Writer + Generate Script `systemPrompt`/`userInput`/`prompt` fields).
+ * Distinct from PROMPT_HARD_CEILING (an image/video PROMPT budget): these inputs
+ * go straight into an LLM whose context is huge (Claude 200K / GPT 128K+ /
+ * Gemini 1M tokens), so the old flat 10000 was a false blocker on pasting a
+ * document to summarize or rewrite. 100000 chars (~25K input tokens) covers
+ * long-form inputs while still bounding abuse; the OUTPUT stays capped by each
+ * route's maxTokens.
+ */
+export const LLM_TEXT_INPUT_MAX = 100_000
+
 /**
  * Per-provider maximum VIDEO prompt length (chars), VERIFIED against each model's
  * official docs.kie.ai schema (2026-06). Absent → {@link VIDEO_PROMPT_MAX} (8000)
@@ -333,6 +347,7 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "nano-banana",
   "nano-banana-pro",
   "nano-banana-2",
+  "nano-banana-2-lite",
   // T2I providers that auto-route to their i2i sibling when refs are attached
   "gpt-image",
   "gpt-image-2",
@@ -340,6 +355,7 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "qwen",
   "seedream",
   "seedream-5-lite",
+  "seedream-5-pro",
   "flux",
   "flux-flex",
   // Image editing / image-to-image (reference = source image)
@@ -357,6 +373,7 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "qwen-edit",
   "seedream-edit",
   "seedream-5-lite-i2i",
+  "seedream-5-pro-i2i",
   "grok-i2i",
   // Upscale / background ops (source acts as the reference)
   "recraft-remove-bg",
@@ -386,6 +403,7 @@ export const T2I_TO_I2I_VARIANT: Record<string, string> = {
   "qwen": "qwen-i2i",
   "seedream": "seedream-edit",
   "seedream-5-lite": "seedream-5-lite-i2i",
+  "seedream-5-pro": "seedream-5-pro-i2i",
   "flux": "flux-pro-i2i",
   "flux-flex": "flux-i2i",
 }
@@ -405,6 +423,7 @@ export const REF_IMAGE_MAX_LIMITS: Record<string, number> = {
   "nano-banana": 8,
   "nano-banana-pro": 8,
   "nano-banana-2": 4,
+  "nano-banana-2-lite": 10,
   "wan-2.7": 9,
   // Image-to-image (multi-source array)
   "nano-banana-edit": 8,
@@ -414,6 +433,7 @@ export const REF_IMAGE_MAX_LIMITS: Record<string, number> = {
   "flux-pro-i2i": 4,
   "seedream-edit": 16,
   "seedream-5-lite-i2i": 16,
+  "seedream-5-pro-i2i": 16,
   // Single-source i2i (one input image)
   "flux-kontext": 1,
   "flux-kontext-max": 1,
@@ -484,6 +504,8 @@ export const VARIABLE_PRICING_MODELS: Record<string, "quality" | "resolution" |
   "seedream-edit": "quality",
   "seedream-5-lite": "quality",
   "seedream-5-lite-i2i": "quality",
+  "seedream-5-pro": "quality",
+  "seedream-5-pro-i2i": "quality",
   "topaz-image-upscale": "resolution",
   "ideogram-edit": "rendering-speed",
   "ideogram-remix": "rendering-speed",
@@ -495,7 +517,7 @@ export const VARIABLE_PRICING_MODELS: Record<string, "quality" | "resolution" |
 
 
 // Models where quality=high triggers composite credit identifier
-export const HIGH_QUALITY_PROVIDERS = new Set(["gpt-image", "gpt-image-i2i", "seedream", "seedream-edit", "seedream-5-lite", "seedream-5-lite-i2i"])
+export const HIGH_QUALITY_PROVIDERS = new Set(["gpt-image", "gpt-image-i2i", "seedream", "seedream-edit", "seedream-5-lite", "seedream-5-lite-i2i", "seedream-5-pro", "seedream-5-pro-i2i"])
 
 // Models where resolution=2K triggers composite credit identifier
 export const TWO_K_RESOLUTION_PROVIDERS = new Set(["flux", "flux-pro-i2i", "flux-flex", "flux-i2i"])
@@ -522,6 +544,7 @@ export const IMAGE_GEN_PROVIDERS = [
   "flux",
   "nano-banana-pro",
   "nano-banana-2",
+  "nano-banana-2-lite",
   "grok",
   "gpt-image",
   "gpt-image-2",
@@ -532,6 +555,7 @@ export const IMAGE_GEN_PROVIDERS = [
   "qwen",
   "seedream",
   "seedream-5-lite",
+  "seedream-5-pro",
   "flux-flex",
   "flux-kontext",
   "flux-kontext-max",
@@ -548,6 +572,7 @@ export const IMAGE_GEN_PROVIDERS = [
 export const IMAGE_I2I_PROVIDERS = [
   "nano-banana",
   "nano-banana-2",
+  "nano-banana-2-lite",
   "nano-banana-pro",
   "grok-i2i",
   "flux-i2i",
@@ -561,6 +586,7 @@ export const IMAGE_I2I_PROVIDERS = [
   "qwen-edit",
   "seedream-edit",
   "seedream-5-lite-i2i",
+  "seedream-5-pro-i2i",
   "flux-kontext",
   "flux-kontext-max",
   // Replicate Open (uncensored) — multi-image Kontext via Replicate
@@ -1003,10 +1029,12 @@ export const IMAGE_MASK_MODE: Record<ImageGenProvider, ImageMaskMode> = {
   "nano-banana": "prompt",
   "nano-banana-pro": "prompt",
   "nano-banana-2": "prompt",
+  "nano-banana-2-lite": "prompt",
   "gpt-image": "prompt",
   "gpt-image-2": "prompt",
   "seedream": "prompt",
   "seedream-5-lite": "prompt",
+  "seedream-5-pro": "prompt",
   "qwen": "prompt",
   "flux-kontext": "prompt",
   "flux-kontext-max": "prompt",
@@ -1129,6 +1157,29 @@ export const SEEDANCE_2_REF_LIMITS = {
   audio: 3,
 } as const
 
+/**
+ * KIE r2v REFERENCE-VIDEO MINIMUM (seconds) for the Seedance 2.0 family — the
+ * provider hard-rejects shorter reference clips with a 400 BEFORE generation:
+ * "the parameter video duration (seconds) specified in the request must be
+ * greater than or equal to 1.8 for model dreamina-seedance-2-0-fast in r2v"
+ * (2026-07-13, job dbf95612 — every 1.0s continuation tail failed
+ * deterministically). Mirror of the reference-AUDIO maximum below.
+ */
+export const SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC = 1.8
+
+/**
+ * The continuation-reference length (seconds) every Seedance-2 chaining
+ * feature actually cuts — extend-node tails, generate-video-pro segment
+ * tails, edit-video-pro refOut/refIn brackets — AND the length the gvp/evp
+ * credit formulas bill per continuation join. Clears the provider floor
+ * above with margin while staying short enough to keep the model focused on
+ * continuing the boundary motion instead of re-staging the whole clip.
+ * Guarded ≥ floor by model-constants tests; the private-plugin twin
+ * (nodaro-cloud-plugins chain.ts TAIL_SEC / bridge-math.ts MIN_REF) is
+ * guarded by that repo's r2v-ref-floor.test.ts — keep the two in sync.
+ */
+export const SEEDANCE_2_CONTINUATION_REF_SEC = 2
+
 /**
  * Trim-stitch parameters for the seedance-2-extend provider (spike-validated
  * 2026-06-11):
@@ -1147,10 +1198,11 @@ export const SEEDANCE_2_EXTEND_STITCH = {
   trimHeadFrames: 3,
   /** Boundary audio fade length (seconds), timeline-preserving. */
   audioFadeSec: 0.15,
-  /** Seconds of the source's TAIL passed as the @video_1 reference —
-   *  spike-validated: a short tail keeps the model focused on continuing
-   *  the boundary motion instead of re-staging the whole clip. */
-  referenceTailSeconds: 1,
+  /** Seconds of the source's TAIL passed as the @video_1 reference — short
+   *  keeps the model focused on continuing the boundary motion; the value is
+   *  floored by SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC (the original spike's 1s
+   *  tail is now provider-rejected). */
+  referenceTailSeconds: SEEDANCE_2_CONTINUATION_REF_SEC,
 } as const
 
 /**

package/src/node-default-mappings.ts

@@ -174,6 +174,8 @@ const QUALITY_MAP: Record<string, QualityMapping> = {
   "seedream-edit":       { field: "quality",    values: { low: "basic",  mid: "basic",  high: "high" } },
   "seedream-5-lite":     { field: "quality",    values: { low: "basic",  mid: "basic",  high: "high" } },
   "seedream-5-lite-i2i": { field: "quality",    values: { low: "basic",  mid: "basic",  high: "high" } },
+  "seedream-5-pro":      { field: "quality",    values: { low: "basic",  mid: "basic",  high: "high" } },
+  "seedream-5-pro-i2i":  { field: "quality",    values: { low: "basic",  mid: "basic",  high: "high" } },
   // Video gen — resolution-style (720p/1080p)
   "veo3":                { field: "resolution", values: { low: "720p", mid: "1080p", high: "1080p" } },
   "veo3.1":              { field: "resolution", values: { low: "720p", mid: "1080p", high: "1080p" } },
@@ -248,6 +250,7 @@ const GENERATE_IMAGE_PROVIDER_TO_MODEL: Record<string, string> = {
   "nano-banana": "gemini-2.5-flash-image",
   "nano-banana-pro": "gemini-2.5-flash-image",
   "nano-banana-2": "gemini-2.5-flash-image",
+  "nano-banana-2-lite": "gemini-3.1-flash-lite-image",
 }
 
 export function deriveLinkedFields(