@nodaro/shared 2.8.0 → 2.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "2.8.0",
+  "version": "2.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__/llm-models.test.ts

@@ -392,10 +392,11 @@ describe("LLM_FEATURE_DEFAULTS", () => {
     "translate",
     "image-critic",
     "pick-best-llm",
+    "workflow-copilot",
   ]
 
-  it("has entries for all 16 features", () => {
-    expect(Object.keys(LLM_FEATURE_DEFAULTS)).toHaveLength(16)
+  it("has entries for all 17 features", () => {
+    expect(Object.keys(LLM_FEATURE_DEFAULTS)).toHaveLength(17)
     for (const feature of ALL_FEATURES) {
       expect(LLM_FEATURE_DEFAULTS).toHaveProperty(feature)
     }

package/src/__tests__/organizations-types.test.ts

@@ -0,0 +1,61 @@
+import { describe, expect, it } from "vitest"
+import {
+  ACCESS_LEVELS,
+  COLLABORATOR_ROLES,
+  MEMBER_STATUSES,
+  ORG_ERROR_CODES,
+  ORG_KINDS,
+  ORG_ROLES,
+  OrgSettingsSchema,
+  PRESET_SETTING_KEYS,
+  PresetSettingsSchema,
+  WORKSPACE_ROLES,
+  WorkspaceSettingsSchema,
+} from "../organizations/index.js"
+
+describe("organizations wire contract — enums", () => {
+  it("every enum is non-empty and duplicate-free", () => {
+    for (const list of [ORG_KINDS, ORG_ROLES, WORKSPACE_ROLES, MEMBER_STATUSES, COLLABORATOR_ROLES, ACCESS_LEVELS, ORG_ERROR_CODES]) {
+      expect(list.length).toBeGreaterThan(0)
+      expect(new Set(list).size).toBe(list.length)
+    }
+  })
+
+  it("error codes are snake_case identifiers", () => {
+    for (const code of ORG_ERROR_CODES) expect(code).toMatch(/^[a-z][a-z_]*[a-z]$/)
+  })
+})
+
+describe("organizations wire contract — settings request schemas", () => {
+  it("the preset shape has exactly the nine resolvable keys", () => {
+    expect([...PRESET_SETTING_KEYS].sort()).toEqual(
+      [
+        "admin_access",
+        "collaborators_can_invite",
+        "default_workflow_visibility",
+        "member_access_to_shared",
+        "member_caps_enabled",
+        "members_can_create_projects",
+        "personal_space_enabled",
+        "policy_survives_suspension",
+        "workspace_admins_can_invite",
+      ].sort(),
+    )
+    expect(PresetSettingsSchema.safeParse({}).success).toBe(false)
+  })
+
+  it("workspace settings are a partial of the preset; unknown keys are stripped; bad values rejected", () => {
+    expect(WorkspaceSettingsSchema.parse({ admin_access: "edit", rogue: 1 })).toEqual({ admin_access: "edit" })
+    expect(WorkspaceSettingsSchema.safeParse({}).success).toBe(true)
+    expect(WorkspaceSettingsSchema.safeParse({ admin_access: "owner" }).success).toBe(false)
+    expect(WorkspaceSettingsSchema.safeParse({ member_caps_enabled: "yes" }).success).toBe(false)
+  })
+
+  it("org settings accept lower-case domains only and string vocabulary overrides", () => {
+    expect(OrgSettingsSchema.safeParse({ allowed_email_domains: ["school.edu", "sub.school.ac.il"] }).success).toBe(true)
+    expect(OrgSettingsSchema.safeParse({ allowed_email_domains: ["School.edu"] }).success).toBe(false)
+    expect(OrgSettingsSchema.safeParse({ allowed_email_domains: ["not a domain"] }).success).toBe(false)
+    expect(OrgSettingsSchema.safeParse({ vocabulary_overrides: { workspace: "Cohort" } }).success).toBe(true)
+    expect(OrgSettingsSchema.safeParse({ vocabulary_overrides: { workspace: 3 } }).success).toBe(false)
+  })
+})

package/src/__tests__/producer-types.test.ts

@@ -23,6 +23,17 @@ describe("producer-types", () => {
     DYNAMIC_PRODUCER_TYPES,
   } as const
 
+  // still-to-video (still image + audio → MP4 via local FFmpeg) has a video
+  // OUTPUT handle — absent from this set, every downstream video input would
+  // hard-reject its edges (the "cannot connect the outputs" bug class).
+  it("registers still-to-video as a video producer", () => {
+    expect(VIDEO_PRODUCER_TYPES.has("still-to-video")).toBe(true)
+  })
+
+  it("registers slideshow as a video producer (still-to-video's N-image companion)", () => {
+    expect(VIDEO_PRODUCER_TYPES.has("slideshow")).toBe(true)
+  })
+
   it("registers voice-changer-pro as an audio producer (its default output)", () => {
     expect(AUDIO_PRODUCER_TYPES.has("voice-changer-pro")).toBe(true)
   })

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

@@ -102,9 +102,13 @@ describe("per-model prompt length limits", () => {
   })
 
   describe("Suno per-version caps", () => {
-    it("prompt: 500 non-custom; 3000 V4 custom; 5000 V4.5+/V5 custom", () => {
-      expect(getMaxSunoPromptChars("V4", false)).toBe(500)
-      expect(getMaxSunoPromptChars("V5", false)).toBe(500)
+    // Non-custom was 500 until 2026-08-19 — six times under the provider's
+    // documented 3000, and the route truncates rather than rejects, so a
+    // 950-char recast score brief reached Suno cut to exactly 500 mid-word.
+    it("prompt: 3000 non-custom (all models); 3000 V4 custom; 5000 V4.5+/V5 custom", () => {
+      expect(getMaxSunoPromptChars("V4", false)).toBe(3000)
+      expect(getMaxSunoPromptChars("V5", false)).toBe(3000)
+      expect(getMaxSunoPromptChars("V5_5", false)).toBe(3000)
       expect(getMaxSunoPromptChars("V4", true)).toBe(3000)
       expect(getMaxSunoPromptChars("V4_5", true)).toBe(5000)
       expect(getMaxSunoPromptChars("V5", true)).toBe(5000)

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

@@ -11,9 +11,8 @@ import {
  *  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. */
+ *  seconds; do NOT "optimize" it back below the floor. The plugin repo
+ *  carries twin constants guarded by its own tests — keep the two 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)

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

@@ -157,7 +157,7 @@ describe("bare video-analysis node-type credit id", () => {
     // 24 and the schedule regenerated ~47% lower at the ceiling bucket, and 300
     // wrote 2064: the V1 hybrid-smart reprice (task A3) moved `smart` to a
     // multi-roll plan (native skeleton + donor rolls, always refined) and
-    // trued up every tier's judge/refine terms from staging measurement).
+    // trued up every tier's judge/refine terms).
     expect(ceiling).toBe(2064)
   })
 

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

@@ -15,7 +15,7 @@ import {
 
 // The measured-rate constants and the $-derived `videoAnalysisBucketCredits`
 // formula are PRIVATE, in @nodaroai/cloud-plugins
-// (src/plugins/video-analysis/cost.ts) — its tests (the worked-example
+// (in the plugin repo) — 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
@@ -121,7 +121,7 @@ describe("video-analysis-pricing", () => {
   })
 
   // Full drift-detection against the live $-formula lives in the PRIVATE
-  // plugin repo (src/plugins/video-analysis/__tests__/cost.test.ts) — the
+  // plugin repo — the
   // formula moved there in 2026-07 and the app-side test was deleted with it,
   // so nothing in THIS repo can recompute these numbers. This is a lightweight
   // shape check that the precomputed table covers every legal id.

package/src/__tests__/video-mode-for-inputs.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, it } from "vitest"
+import {
+  VIDEO_MODE_ALIASES,
+  VIDEO_REF_LIMITS_BY_PROVIDER,
+  resolveVideoModeForInputs,
+  resolveVideoProviderForMode,
+} from "../model-constants.js"
+
+/**
+ * #861 — reference images wired to Grok Imagine 1 without a start frame were
+ * silently dropped: the run resolved to text-to-video, the t2v twin (`grok`)
+ * has no image parameter, and nothing said so. The mode must follow what the
+ * model can CARRY, derived from the catalog's reference caps — not a name.
+ */
+const I2V = "image-to-video"
+const T2V = "text-to-video"
+
+describe("resolveVideoModeForInputs", () => {
+  it("a start frame is image-to-video for every provider", () => {
+    for (const id of ["grok-i2v", "grok", "seedance-2", "kling", "veo3", "wan-i2v", undefined]) {
+      expect(resolveVideoModeForInputs(id, { hasStartFrame: true, hasImageRefs: false })).toBe(I2V)
+      expect(resolveVideoModeForInputs(id, { hasStartFrame: true, hasImageRefs: true })).toBe(I2V)
+    }
+  })
+
+  it("nothing wired is text-to-video", () => {
+    expect(resolveVideoModeForInputs("grok-i2v", { hasStartFrame: false, hasImageRefs: false })).toBe(T2V)
+    expect(resolveVideoModeForInputs(undefined, { hasStartFrame: false, hasImageRefs: true })).toBe(T2V)
+  })
+
+  it("refs alone route Grok Imagine 1 to its i2v twin — the only one that can carry them (#861)", () => {
+    // Whichever member id the node stored (base/i2v/t2v all appear in old workflows).
+    for (const id of ["grok-i2v", "grok"]) {
+      expect(resolveVideoModeForInputs(id, { hasStartFrame: false, hasImageRefs: true })).toBe(I2V)
+    }
+    // The premise, pinned: i2v carries refs, t2v does not.
+    expect(VIDEO_REF_LIMITS_BY_PROVIDER["grok-i2v"]?.images).toBeGreaterThan(0)
+    expect(VIDEO_REF_LIMITS_BY_PROVIDER["grok"]).toBeUndefined()
+  })
+
+  it("single-id models are untouched: the same id serves both modes, so there is nothing to re-route", () => {
+    // seedance-2 / gemini-omni-video / veo forward refs on their t2v path
+    // (generate-video.md mode table). kling-3-omni is i2v-only and keeps its
+    // documented orchestrator behavior (image_required on the t2v path) —
+    // whether refs alone should satisfy it is a separate question from #861.
+    for (const id of ["seedance-2", "gemini-omni-video", "veo3.1", "kling-3-omni"]) {
+      expect(resolveVideoModeForInputs(id, { hasStartFrame: false, hasImageRefs: true })).toBe(T2V)
+    }
+  })
+
+  it("a split-id model with no ref support on either twin is unaffected (wan, happyhorse)", () => {
+    for (const id of ["wan-i2v", "wan-2.7-i2v", "happyhorse-i2v"]) {
+      expect(resolveVideoModeForInputs(id, { hasStartFrame: false, hasImageRefs: true })).toBe(T2V)
+    }
+  })
+
+  it("every alias group is classified — a new split-id model lands in one of the two pinned outcomes", () => {
+    // Explicit per-group expectations (not a re-derivation of the formula):
+    // grok is the one group whose twins differ on ref support today.
+    const expectedByBase: Record<string, "image-to-video" | "text-to-video"> = {
+      "grok-i2v": I2V,
+      "wan-i2v": T2V,
+      "wan-2.7-i2v": T2V,
+      "happyhorse-i2v": T2V,
+    }
+    expect(VIDEO_MODE_ALIASES.map((g) => g.base).sort()).toEqual(Object.keys(expectedByBase).sort())
+    for (const g of VIDEO_MODE_ALIASES) {
+      const expected = expectedByBase[g.base]!
+      expect(resolveVideoModeForInputs(g.base, { hasStartFrame: false, hasImageRefs: true }), g.base).toBe(expected)
+      // The mode it picks resolves to the twin that can actually run it.
+      if (expected === I2V) expect(resolveVideoProviderForMode(g.base, expected)).toBe(g.i2v)
+    }
+  })
+})

package/src/combine-transitions.ts

@@ -480,3 +480,41 @@ export function resolveXfadeName(id: string): string | null {
   }
   return entry.xfade
 }
+
+/**
+ * Map a `transition` PARAMETER-NODE pick (the @nodaro/prompts creative
+ * catalog — prose-hint transitions for AI video prompts) onto the ffmpeg
+ * xfade vocabulary above. The two vocabularies are deliberately different
+ * (the picker describes shots, this table describes blends); only the
+ * visually-faithful subset maps — everything else falls back to `cut`.
+ *
+ * Consumed by the slideshow node (its transition TYPE comes from a wired
+ * transition parameter node; unwired defaults to cut). Kept here — not in
+ * @nodaro/prompts — because the dependency points prompts → shared, and the
+ * ids are plain strings on both sides.
+ */
+export const PICKER_TO_COMBINE_TRANSITION: Readonly<Record<string, string>> = {
+  "none": "cut",
+  "auto": "dissolve", // an explicitly wired "auto" wants A blend — the classic slideshow default
+  "cross-dissolve": "dissolve",
+  "fade-to-black": "dip-to-black",
+  "fade-to-white": "dip-to-white",
+  "iris": "circle-open",
+  "wipe": "wipe-left",
+  "pixelate-reform": "pixelize",
+  "dissolve-to-mist": "hblur",
+  "match-cut": "cut",
+  "smash-cut": "cut",
+  "freeze-frame-jump": "cut",
+}
+
+/**
+ * Resolve ANY transition string a slideshow may receive — a combine id
+ * (already valid), a picker id (mapped), or anything else (→ cut).
+ */
+export function resolveSlideshowTransition(value: string | undefined | null): string {
+  if (!value) return "cut"
+  if (COMBINE_TRANSITION_IDS.includes(value)) return value
+  return PICKER_TO_COMBINE_TRANSITION[value] ?? "cut"
+}
+

package/src/credit-estimators/video-utils.ts

@@ -155,7 +155,7 @@ export function estimateLoopTrimAddonCredits(
          Math.ceil(frames / VIDEO_UTIL_PRICING.FRAMES_PER_CREDIT)
 }
 
-/** BASE credits (at-cost) for assemble-narrated-video: 3 flat + 1 per 6
+/** BASE credits for assemble-narrated-video: 3 flat + 1 per 6
  *  blocks. 6→4, 24→7, 60→13. Single source of truth shared by the backend
  *  route/creditGuard (`backend/src/providers/video/narrated-block-fit.ts`
  *  re-exports this) and the frontend pre-run estimate

package/src/featured-entities.ts

@@ -1,5 +1,5 @@
 /**
- * Featured entity starter catalog (north-star §6 ③ — the "Featured" tab of each
+ * Featured entity starter catalog (the "Featured" tab of each
  * entity Library).
  *
  * These are app-provided starter presets: a curated visual description per

package/src/i18n/types.ts

@@ -52,8 +52,6 @@ export interface LanguageDefinition {
   readonly shortCode: string
   /** Reading direction. */
   readonly dir: LocaleDirection
-  /** Optional flag emoji for visual recognition. */
-  readonly flag: string
 }
 
 /**
@@ -62,18 +60,18 @@ export interface LanguageDefinition {
  * languages, then RTL languages last.
  */
 export const LANGUAGES: ReadonlyArray<LanguageDefinition> = [
-  { id: "en",    englishName: "English",              nativeName: "English",         shortCode: "EN",  dir: "ltr", flag: "🇬🇧" },
-  { id: "es",    englishName: "Spanish",              nativeName: "Español",         shortCode: "ES",  dir: "ltr", flag: "🇪🇸" },
-  { id: "fr",    englishName: "French",               nativeName: "Français",        shortCode: "FR",  dir: "ltr", flag: "🇫🇷" },
-  { id: "de",    englishName: "German",               nativeName: "Deutsch",         shortCode: "DE",  dir: "ltr", flag: "🇩🇪" },
-  { id: "pt-BR", englishName: "Portuguese (Brazil)",  nativeName: "Português",       shortCode: "PT",  dir: "ltr", flag: "🇧🇷" },
-  { id: "ru",    englishName: "Russian",              nativeName: "Русский",         shortCode: "RU",  dir: "ltr", flag: "🇷🇺" },
-  { id: "hi",    englishName: "Hindi",                nativeName: "हिन्दी",          shortCode: "HI",  dir: "ltr", flag: "🇮🇳" },
-  { id: "ja",    englishName: "Japanese",             nativeName: "日本語",          shortCode: "JA",  dir: "ltr", flag: "🇯🇵" },
-  { id: "ko",    englishName: "Korean",               nativeName: "한국어",          shortCode: "KO",  dir: "ltr", flag: "🇰🇷" },
-  { id: "zh-CN", englishName: "Chinese (Simplified)", nativeName: "简体中文",        shortCode: "ZH",  dir: "ltr", flag: "🇨🇳" },
-  { id: "he",    englishName: "Hebrew",               nativeName: "עברית",           shortCode: "HE",  dir: "rtl", flag: "🇮🇱" },
-  { id: "ar",    englishName: "Arabic",               nativeName: "العربية",         shortCode: "AR",  dir: "rtl", flag: "🇸🇦" },
+  { id: "en",    englishName: "English",              nativeName: "English",         shortCode: "EN",  dir: "ltr" },
+  { id: "es",    englishName: "Spanish",              nativeName: "Español",         shortCode: "ES",  dir: "ltr" },
+  { id: "fr",    englishName: "French",               nativeName: "Français",        shortCode: "FR",  dir: "ltr" },
+  { id: "de",    englishName: "German",               nativeName: "Deutsch",         shortCode: "DE",  dir: "ltr" },
+  { id: "pt-BR", englishName: "Portuguese (Brazil)",  nativeName: "Português",       shortCode: "PT",  dir: "ltr" },
+  { id: "ru",    englishName: "Russian",              nativeName: "Русский",         shortCode: "RU",  dir: "ltr" },
+  { id: "hi",    englishName: "Hindi",                nativeName: "हिन्दी",          shortCode: "HI",  dir: "ltr" },
+  { id: "ja",    englishName: "Japanese",             nativeName: "日本語",          shortCode: "JA",  dir: "ltr" },
+  { id: "ko",    englishName: "Korean",               nativeName: "한국어",          shortCode: "KO",  dir: "ltr" },
+  { id: "zh-CN", englishName: "Chinese (Simplified)", nativeName: "简体中文",        shortCode: "ZH",  dir: "ltr" },
+  { id: "he",    englishName: "Hebrew",               nativeName: "עברית",           shortCode: "HE",  dir: "rtl" },
+  { id: "ar",    englishName: "Arabic",               nativeName: "العربية",         shortCode: "AR",  dir: "rtl" },
 ] as const
 
 export const LOCALE_IDS: ReadonlyArray<LocaleId> = LANGUAGES.map((l) => l.id)

package/src/index.ts

@@ -110,6 +110,7 @@ export {
   VIDEO_MODE_ALIASES,
   VIDEO_GEN_COLLAPSED_T2V_IDS,
   resolveVideoProviderForMode,
+  resolveVideoModeForInputs,
   isSeedance2Provider,
   MINIMAX_H3_PROVIDERS,
   isMinimaxH3Provider,
@@ -396,7 +397,6 @@ export {
   TILT_CARRIED_FRACTION,
   isTiltDirection,
   defaultCarriedFraction,
-  buildSurroundFillPrompt,
   type SurroundDirection,
 } from "./surround.js"
 
@@ -762,6 +762,9 @@ export type {
   WorkflowExportObject,
   WorkflowExportCreature,
   WorkflowExportLocation,
+  WorkflowMediaRef,
+  WorkflowPortability,
+  WorkflowImportReport,
 } from "./workflow-export.js"
 export { stripExportContent } from "./workflow-export.js"
 
@@ -860,6 +863,8 @@ export * from "./reduce-strategy-registry.js"
 export {
   COMBINE_TRANSITIONS,
   COMBINE_TRANSITION_IDS,
+  PICKER_TO_COMBINE_TRANSITION,
+  resolveSlideshowTransition,
   COMBINE_TRANSITION_GROUP_ORDER,
   COMBINE_TRANSITION_GROUP_LABELS,
   getCombineTransition,
@@ -886,6 +891,8 @@ export {
   FAN_OUT_EACH_TYPES,
 } from "./producer-types.js"
 
+export { SUNO_TRACK_SOURCE_TYPES } from "./suno-track-sources.js"
+
 export {
   VOICE_CHANGER_MODELS,
   VOICE_CHANGER_MODEL_IDS,
@@ -953,3 +960,6 @@ export * from "./smart-cut-windows.js"
 
 export * from "./entity-asset-types.js"
 export * from "./hint-graph-types.js"
+
+// --- Organizations (second tenancy axis): wire contract only — enums, settings request schemas, error codes ---
+export * from "./organizations/index.js"

package/src/llm-models.ts

@@ -529,6 +529,9 @@ export type LlmFeature =
   // feature (not ai-writer, which it used to piggyback on) so the model
   // default and the tiered credit ids are the strategy's own.
   | "pick-best-llm"
+  // In-app Workflow Copilot turns (backend agent loop; metered, reservation
+  // ceiling under `STATIC_CREDIT_COSTS["workflow-copilot"]`).
+  | "workflow-copilot"
 
 /** Engine-dependent LlmFeature for the motion-graphics node (design §8: every credit-id site must branch on engine). */
 export function motionGraphicsFeature(engine?: string): LlmFeature {
@@ -553,6 +556,7 @@ export const LLM_FEATURE_DEFAULTS: Record<LlmFeature, string> = {
   "translate": "gemini-3.6-flash",
   "image-critic": "claude-sonnet-4.6",
   "pick-best-llm": "claude-sonnet-4.6",
+  "workflow-copilot": "claude-sonnet-5",
 }
 
 /**

package/src/model-catalog.ts

@@ -886,6 +886,9 @@ const IMAGE_MODELS: Record<string, ModelCatalogEntry> = {
     description:
       "Grok Imagine Image 2.0 — expressive, high-contrast t2i. Generations chain into grok-2-segment (free named region masks) and grok-2-edit (region-targeted edits).",
     useCases: ["stylized", "expressive", "general"],
+    // Refs auto-route to grok-2-i2i (segment-map → image-edit chain); ONE
+    // reference (REF_IMAGE_MAX_LIMITS).
+    features: ["reference-image"],
     aspectRatios: GROK_RATIOS,
     pricing: [{ identifier: "grok-2", credits: 10 }],
   },
@@ -901,6 +904,22 @@ const IMAGE_MODELS: Record<string, ModelCatalogEntry> = {
     useCases: ["edit", "region-edit"],
     pricing: [{ identifier: "grok-2-edit", credits: 10 }],
   },
+  // Auto-selected when references are attached to grok-2 (T2I_TO_I2I_VARIANT):
+  // the t2i endpoint takes no image, so the FREE segment-map mints a task id
+  // from the reference URL and image-edit consumes it. Single reference.
+  "grok-2-i2i": {
+    id: "grok-2-i2i",
+    kind: "image",
+    modes: ["i2i"] as const,
+    family: "xAI",
+    label: "Grok Imagine 2 (reference)",
+    series: "Grok",
+    description:
+      "grok-2 guided by ONE reference image via the segment-map → image-edit chain — preserves the reference's composition while applying the prompt.",
+    useCases: ["restyle", "edit", "reference"],
+    features: ["reference-image"],
+    pricing: [{ identifier: "grok-2-i2i", credits: 10 }],
+  },
   "grok-2-segment": {
     id: "grok-2-segment",
     kind: "image",

package/src/model-constants.ts

@@ -5,7 +5,7 @@
 import { z } from "zod"
 import { MODEL_CATALOG } from "./model-catalog.js"
 
-/** Base USD cost per 1 Nodaro credit, at cost. Used for cost→credit conversion. */
+/** Base USD value of 1 Nodaro credit. Used for cost→credit conversion. */
 export const CREDIT_BASE_USD = 0.002
 
 /** Max characters for the (assembled) prompt accepted by the image-generation routes
@@ -232,16 +232,25 @@ export function getMaxTtsChars(provider: string | undefined): number {
  * Suno per-version field caps (from docs.kie.ai/suno-api/generate-music). The old
  * flat {@link SUNO_TEXT_MAX} (3000) was simultaneously too low for V4.5+/V5
  * prompts (5000) and too high for `style` (1000) and `title` (80).
- *   - prompt / lyrics: 500 in non-custom mode (all versions); in custom mode
+ *   - prompt / lyrics: 3000 in non-custom mode (all versions); in custom mode
  *     3000 for V4/V3.5 and 5000 for V4.5 / V4.5PLUS / V4.5ALL / V5 / V5.5.
  *   - style: 200 for V4/V3.5, 1000 for V4.5+.
  *   - title: 80 (all versions).
  */
 export const SUNO_TITLE_MAX = 80
 
-/** Max Suno `prompt` (= lyrics in custom mode) length for a model version. */
+/**
+ * Max Suno `prompt` (= lyrics in custom mode) length for a model version.
+ *
+ * NON-CUSTOM WAS 500 UNTIL 2026-08-19 — six times under the provider's
+ * documented 3000, and the route TRUNCATES to this number instead of
+ * rejecting, so everything past it vanished without a trace. Field evidence:
+ * a 950-character recast score brief (instruments, vocal, the source's own
+ * scat syllables, the arrangement's arc) reached Suno as exactly 500
+ * characters, cut mid-word.
+ */
 export function getMaxSunoPromptChars(model: string | undefined, customMode: boolean): number {
-  if (!customMode) return 500
+  if (!customMode) return 3000
   return model === "V4" || model === "V3_5" ? 3000 : 5000
 }
 
@@ -364,6 +373,7 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "gpt-image",
   "gpt-image-2",
   "grok",
+  "grok-2",
   "qwen",
   "seedream",
   "seedream-5-lite",
@@ -374,6 +384,7 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "nano-banana-edit",
   "gpt-image-i2i",
   "gpt-image-2-i2i",
+  "grok-2-i2i",
   "flux-i2i",
   "flux-pro-i2i",
   "flux-kontext",
@@ -412,6 +423,9 @@ export const T2I_TO_I2I_VARIANT: Record<string, string> = {
   "gpt-image": "gpt-image-i2i",
   "gpt-image-2": "gpt-image-2-i2i",
   "grok": "grok-i2i",
+  // grok-2's t2i takes NO image input; its "i2i" is the segment-map(image_url)
+  // → image-edit(task_id) chain in the KIE provider (single reference).
+  "grok-2": "grok-2-i2i",
   "qwen": "qwen-i2i",
   "seedream": "seedream-edit",
   "seedream-5-lite": "seedream-5-lite-i2i",
@@ -437,6 +451,8 @@ export const REF_IMAGE_MAX_LIMITS: Record<string, number> = {
   "nano-banana-2": 4,
   "nano-banana-2-lite": 10,
   "wan-2.7": 9,
+  // grok-2 reference chain consumes exactly one image (segment-map input).
+  "grok-2-i2i": 1,
   // Image-to-image (multi-source array)
   "nano-banana-edit": 8,
   "gpt-image-i2i": 16,
@@ -592,6 +608,7 @@ export const IMAGE_I2I_PROVIDERS = [
   "flux-pro-i2i",
   "gpt-image-i2i",
   "gpt-image-2-i2i",
+  "grok-2-i2i",
   "ideogram-edit",
   "ideogram-remix",
   "ideogram-reframe",
@@ -824,6 +841,35 @@ export function resolveVideoProviderForMode(
   return provider
 }
 
+/**
+ * Which execution mode a unified Generate Video run takes from what is wired.
+ * Shared by the frontend DAG executor (`execute-node.ts`) and the backend
+ * orchestrator (`payload-builder.ts`) so the two cannot disagree.
+ *
+ * A start frame is image-to-video, full stop. Reference images ALONE are the
+ * nuance: most models forward refs on either path, but a split-id model
+ * (VIDEO_MODE_ALIASES) can carry them on one twin only — Grok Imagine 1's
+ * text-to-video endpoint has no image parameter at all, while its i2v twin
+ * takes up to 7. Refs wired without a start frame used to resolve to t2v →
+ * `grok` → silently dropped (#861). When refs are present and ONLY the i2v
+ * twin can carry them, the run is image-to-video with the refs as its images.
+ * Derived from VIDEO_REF_LIMITS_BY_PROVIDER (= the catalog's `reference-image`
+ * feature), never from a provider name; single-id models are untouched
+ * because both twins are the same id.
+ */
+export function resolveVideoModeForInputs(
+  provider: string | undefined,
+  inputs: { readonly hasStartFrame: boolean; readonly hasImageRefs: boolean },
+): "image-to-video" | "text-to-video" {
+  if (inputs.hasStartFrame) return "image-to-video"
+  if (!provider || !inputs.hasImageRefs) return "text-to-video"
+  const i2v = resolveVideoProviderForMode(provider, "image-to-video")
+  const t2v = resolveVideoProviderForMode(provider, "text-to-video")
+  if (i2v === t2v) return "text-to-video"
+  const carriesImageRefs = (id: string) => (VIDEO_REF_LIMITS_BY_PROVIDER[id]?.images ?? 0) > 0
+  return carriesImageRefs(i2v) && !carriesImageRefs(t2v) ? "image-to-video" : "text-to-video"
+}
+
 /**
  * t2v twin ids hidden from the unified Generate Video picker — the i2v/base
  * entry already represents both modes (execution remaps by image presence).
@@ -1526,9 +1572,8 @@ export const SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC = 1.8
  * 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.
+ * Guarded ≥ floor by model-constants tests; the plugin repo carries a twin
+ * constant guarded by its own tests — keep the two in sync.
  */
 export const SEEDANCE_2_CONTINUATION_REF_SEC = 2
 

package/src/organizations/index.ts

@@ -0,0 +1,2 @@
+export * from "./types.js"
+export * from "./views.js"