@nodaro/shared 2.19.0 → 2.21.0

package/dist/index.d.cts

@@ -524,6 +524,33 @@ declare const CREDIT_BASE_USD = 0.002;
  *  (generate-image, image-to-image, edit-image). Single source of truth — the route Zod
  *  schemas and the factory-preset guard test all read this. Prompt cap ONLY (not negativePrompt). */
 declare const IMAGE_PROMPT_MAX = 5000;
+/**
+ * The ONE aspect-ratio vocabulary the image routes' Zod enums are built from —
+ * `/v1/generate-image`, `/v1/image-to-image` and `/v1/edit-image` all declare
+ * `z.enum(IMAGE_ASPECT_RATIO_VALUES)` instead of keeping three literal lists
+ * that drift.
+ *
+ * It is the UNION of every ratio any `kind: "image"` catalog entry declares, so
+ * a value the picker offers can never 400 at the route. That gap has shipped
+ * twice — Wan 2.7's ultra-wide `8:1`/`1:8` (fixed on generate-image only) and
+ * Nano Banana 2 Lite's banner `4:1`/`1:4` (still open until this tuple landed).
+ * `packages/shared/src/__tests__/image-pricing-catalog-coverage.test.ts` fails
+ * the build if a new model declares a ratio this tuple is missing.
+ *
+ * This enum is a VOCABULARY BOUND, not a per-model gate: it only stops a
+ * free-form string from reaching a provider as `image_size`. The per-model gate
+ * is the catalog snap (`resolveNormalizedImageGen` → `normalizeModelInput`),
+ * which CORRECTS an unsupported ratio and discloses it in the response's
+ * `adjustments` — never rejects. So widening this tuple is always safe: it
+ * defers a rejection to the correcting snap, which is the desired behaviour.
+ *
+ * `auto` is model-specific (GPT Image 2 / Nano Banana 2 Lite treat it as
+ * "native"); it lives here for the same reason as the rest — the snap drops or
+ * replaces it for models that do not declare it.
+ */
+declare const IMAGE_ASPECT_RATIO_VALUES: readonly ["auto", "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9", "4:1", "1:4", "8:1", "1:8"];
+/** A ratio string the image routes accept (pre-snap vocabulary, not a per-model guarantee). */
+type ImageAspectRatio = typeof IMAGE_ASPECT_RATIO_VALUES[number];
 /**
  * Per-provider maximum ASSEMBLED image-prompt length (chars), VERIFIED against
  * each model's official docs.kie.ai schema (2026-06). Providers absent here use
@@ -560,14 +587,35 @@ declare function getMaxImagePromptChars(provider: string | undefined): number;
 declare const VIDEO_PROMPT_MAX = 8000;
 /**
  * Suno prompt / lyrics / content ceiling — the LARGEST any Suno version accepts
- * in custom mode (V4.5 / V4.5PLUS / V4.5ALL / V5 / V5.5 = 5000). The route Zod
- * uses this as a generous ceiling; the handler clamps to the per-version cap via
- * {@link getMaxSunoPromptChars} (V4/V3.5 = 3000, non-custom = 500). Shared with
- * the editor `maxLength` / counter (warn-don't-block at the per-version cap).
- * `style` and `title` have their own caps ({@link getMaxSunoStyleChars} /
- * {@link SUNO_TITLE_MAX}).
+ * in custom mode (V4.5 / V4.5PLUS / V4.5ALL / V5 / V5.5 = 5000). NOT the route
+ * Zod bound — the routes bind at {@link SUNO_HARD_CEILING} and clamp to the
+ * per-version cap via {@link getMaxSunoPromptChars} (3000 non-custom for every
+ * version; in custom mode 3000 for V4/V3.5, 5000 for V4.5+/V5) before the job
+ * is built. This constant is shared with the editor `maxLength` / counter
+ * (warn-don't-block at the per-version cap). `style` and `title` have their
+ * own caps ({@link getMaxSunoStyleChars} / {@link SUNO_TITLE_MAX}).
  */
 declare const SUNO_TEXT_MAX = 5000;
+/**
+ * Absolute ceiling for every Suno text field on the route Zod schemas
+ * (`prompt`, `lyrics`, `fullLyrics`, `content`, `userPrompt`).
+ *
+ * WARN-DON'T-BLOCK. The per-version caps ({@link getMaxSunoPromptChars} /
+ * {@link getMaxSunoStyleChars}) do the real work — the routes CLAMP to them
+ * before building the job. The Zod bound only exists to stop abuse, so it must
+ * stay generous: until 2026-09 the routes bounded these fields at
+ * {@link SUNO_TEXT_MAX} (5000), which meant a programmatically-set prompt (an
+ * agent, an app run, a FieldMapping) was hard-REJECTED with a 400 before the
+ * clamp could trim it — three app-report rows on 2026-08-19..31.
+ *
+ * DISTINCT FROM {@link PROMPT_HARD_CEILING} on purpose: that one is an
+ * image/video budget pinned to MAX_IMAGE/VIDEO_PROMPT_CHARS_BY_PROVIDER by its
+ * own drift guard. Coupling them would let one modality's limits move the
+ * other's. This one has a single invariant, enforced in
+ * `__tests__/prompt-length-limits.test.ts`: it MUST stay >= every value
+ * getMaxSunoPromptChars / getMaxSunoStyleChars can return.
+ */
+declare const SUNO_HARD_CEILING = 30000;
 /**
  * Absolute ceiling for the `prompt` / `negativePrompt` fields on the image and
  * video routes' Zod schemas. The PER-MODEL limits below (and the editor warning)
@@ -639,9 +687,11 @@ declare const MAX_TTS_CHARS_BY_PROVIDER: Record<string, number>;
 /** Max TTS text length (chars) for a provider: verified override, else {@link TTS_TEXT_MAX}. */
 declare 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).
+ * Suno per-version field caps (from docs.kie.ai/suno-api/generate-music). The
+ * original flat 3000 cap was simultaneously too low for V4.5+/V5 prompts
+ * (5000) and too high for `style` (1000) and `title` (80). ({@link
+ * SUNO_TEXT_MAX} is 5000 today — the largest per-version prompt cap; the
+ * route Zod bound is {@link SUNO_HARD_CEILING}.)
  *   - 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+.
@@ -794,7 +844,7 @@ type ImageToVideoProvider = typeof IMAGE_TO_VIDEO_PROVIDERS[number];
 declare const TEXT_TO_VIDEO_PROVIDERS: readonly ["minimax", "veo3", "veo3.1", "veo3_lite", "kling", "kling-turbo", "kling-3.0", "grok", "seedance", "seedance-2", "seedance-2-fast", "seedance-2-mini", "seedance-2-5", "minimax-h3", "wan", "hailuo-standard", "bytedance-lite", "bytedance-pro", "wan-turbo", "wan-2.7-t2v", "happyhorse", "runway-kie", "gemini-omni-video", "gemini-omni-flash", "wan-3", "wan-3-prime", "ltx-2.3-pro", "ltx-2.3-fast", "grok-imagine-video-1.5", "kling-3-omni", "kling-master", "hailuo-2.3", "hailuo-2.3-pro", "bytedance-pro-fast", "happyhorse-ref2v"];
 type TextToVideoProvider = typeof TEXT_TO_VIDEO_PROVIDERS[number];
 /** Unified video-generation providers (image-to-video ∪ text-to-video) for the generate-video node. */
-declare const VIDEO_GEN_PROVIDERS: readonly ["minimax", "veo3", "veo3.1", "veo3_lite", "kling", "kling-turbo", "kling-3.0", "kling-master", "seedance", "seedance-2", "seedance-2-fast", "seedance-2-mini", "seedance-2-5", "minimax-h3", "hailuo-2.3-pro", "hailuo-2.3", "hailuo-standard", "wan-i2v", "wan-turbo", "bytedance-lite", "bytedance-pro", "bytedance-pro-fast", "grok-i2v", "wan-2.7-i2v", "happyhorse-i2v", "happyhorse-ref2v", "runway-kie", "kling-3-omni", "gemini-omni-video", "gemini-omni-flash", "wan-3", "wan-3-prime", "ltx-2.3-pro", "ltx-2.3-fast", "grok-imagine-video-1.5", ...("veo3" | "kling-3.0" | "seedance-2" | "veo3.1" | "wan-turbo" | "bytedance-lite" | "kling-turbo" | "minimax" | "hailuo-standard" | "grok" | "minimax-h3" | "hailuo-2.3-pro" | "hailuo-2.3" | "veo3_lite" | "gemini-omni-video" | "gemini-omni-flash" | "kling" | "kling-master" | "kling-3-omni" | "grok-imagine-video-1.5" | "seedance" | "seedance-2-fast" | "seedance-2-mini" | "seedance-2-5" | "wan-3" | "wan-3-prime" | "wan" | "wan-2.7-t2v" | "happyhorse" | "happyhorse-ref2v" | "bytedance-pro" | "bytedance-pro-fast" | "runway-kie" | "ltx-2.3-pro" | "ltx-2.3-fast")[]];
+declare const VIDEO_GEN_PROVIDERS: readonly ["minimax", "veo3", "veo3.1", "veo3_lite", "kling", "kling-turbo", "kling-3.0", "kling-master", "seedance", "seedance-2", "seedance-2-fast", "seedance-2-mini", "seedance-2-5", "minimax-h3", "hailuo-2.3-pro", "hailuo-2.3", "hailuo-standard", "wan-i2v", "wan-turbo", "bytedance-lite", "bytedance-pro", "bytedance-pro-fast", "grok-i2v", "wan-2.7-i2v", "happyhorse-i2v", "happyhorse-ref2v", "runway-kie", "kling-3-omni", "gemini-omni-video", "gemini-omni-flash", "wan-3", "wan-3-prime", "ltx-2.3-pro", "ltx-2.3-fast", "grok-imagine-video-1.5", ...("veo3" | "kling-3.0" | "seedance-2" | "veo3.1" | "wan-turbo" | "bytedance-lite" | "kling-turbo" | "minimax" | "hailuo-standard" | "grok" | "minimax-h3" | "hailuo-2.3-pro" | "hailuo-2.3" | "veo3_lite" | "gemini-omni-video" | "gemini-omni-flash" | "kling" | "kling-master" | "kling-3-omni" | "grok-imagine-video-1.5" | "seedance" | "seedance-2-fast" | "seedance-2-mini" | "seedance-2-5" | "wan-3" | "wan-3-prime" | "wan" | "wan-2.7-t2v" | "ltx-2.3-pro" | "ltx-2.3-fast" | "happyhorse" | "happyhorse-ref2v" | "bytedance-pro" | "bytedance-pro-fast" | "runway-kie")[]];
 type VideoGenProvider = typeof VIDEO_GEN_PROVIDERS[number];
 /**
  * Video models that expose DISTINCT provider ids per mode (text-to-video vs
@@ -1270,6 +1320,53 @@ declare const VIDEO_REF_LIMITS_BY_PROVIDER: Record<string, {
     videos?: number;
     audio?: number;
 } | undefined>;
+/** Per-reference-video duration bounds, in seconds. */
+interface RefVideoDurationLimit {
+    minSec: number;
+    maxSec: number;
+    /** Cap on the SUM of all reference-video durations, when the provider has one. */
+    maxTotalSec?: number;
+}
+/**
+ * Reference-video duration limits, provider-declared.
+ *
+ * `VIDEO_REF_LIMITS_BY_PROVIDER` above caps the reference COUNT; these cap the
+ * duration of each clip. Both routes already ffprobe every reference video to
+ * price the run (ee/billing/seedance2-ref-video-credits.ts and
+ * minimax-h3-credits.ts), so the numbers are in hand before the job exists —
+ * and until 2026-09-02 they were discarded, which is why "Each reference video
+ * must be between 2 and 30 seconds" and "video duration 52838 ms, expected
+ * [2000, 15000] ms" were reaching users as post-payment provider rejects
+ * (app-reports §11.3).
+ *
+ * Data-driven, exactly like SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER above:
+ * only providers with a VERIFIED documented limit are listed, so an unknown
+ * provider is never false-rejected.
+ *
+ * Sources: docs.kie.ai/market/bytedance/seedance-2-5 ("Single video duration:
+ * [2, 30] seconds"; "Total duration of reference videos must not exceed 30
+ * seconds") and docs.kie.ai/market/minimax-h3/reference-to-video (reference
+ * videos are "2 to 15 seconds" each and "the total duration of all reference
+ * videos cannot exceed 15 seconds", up to 3 videos) — both fetched 2026-09-02.
+ */
+declare const VIDEO_REF_VIDEO_DURATION_LIMITS: Record<string, RefVideoDurationLimit | undefined>;
+/**
+ * Validate probed reference-video durations against the provider's limits.
+ *
+ * Non-finite / non-positive entries are IGNORED, never rejected: the probe
+ * helpers treat an unreadable clip as a worst-case duration for pricing, and
+ * turning a failed ffprobe into a user-facing 400 would block legitimate runs
+ * on a transient probe failure. Callers therefore pass the RAW per-URL probe
+ * outcomes (a rejected ffprobe arrives here as NaN) — an ignored entry also
+ * contributes nothing to the `maxTotalSec` sum, so a probe blip can never push
+ * an otherwise-legal set over the total cap either.
+ */
+declare function checkRefVideoDurations(provider: string, durationsSec: readonly number[]): {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
 /**
  * Video generation models whose provider API natively accepts a "match the
  * visual input's aspect" token, mapped to that provider's EXACT token.
@@ -1379,8 +1476,8 @@ interface VideoAudioCapability {
 /**
  * Per-model audio capability. Only models that produce SOME audio are listed;
  * anything absent defaults to `{ mode: "none" }` via `getVideoAudioCapability`,
- * so silent models (minimax, hailuo, wan, grok-i2v, gemini-omni-video, runway,
- * pika, …) need no entry. New audio-capable models MUST be added here — the
+ * so silent models (minimax, hailuo, wan-i2v, grok-i2v, runway, pika, …) need
+ * no entry. New audio-capable models MUST be added here — the
  * `video-audio-capability` guard test cross-checks this map against the model
  * configs' `extraParams.sound` / `generate_audio` + VEO/Seedance-2 sets so a
  * forgotten entry fails CI rather than silently disabling audio.
@@ -1841,10 +1938,402 @@ interface ExtraRefCharacterContext {
  */
 declare function expandExtraRefsToConnectedReferences(extras: ReadonlyArray<ExtraRefInput> | undefined, lookupCharacterContext?: (slug: string) => ExtraRefCharacterContext | undefined): ConnectedReference[];
 
+/**
+ * Model catalog — single source of truth for what each Nodaro-exposed model
+ * is, who made it, what it's good for, and which knobs it accepts.
+ *
+ * Consumed by:
+ * - Backend MCP `list_models` tool (renders the nested per-kind / per-family
+ *   response so Claude can pick the right model for a user's intent)
+ * - (future) Frontend config panels — today they read parallel registries
+ *   in `frontend/src/components/editor/config-panels/model-options.ts`; a
+ *   follow-up will migrate them to import from here.
+ *
+ * Authoring rules:
+ * - Keep `description` to one line (≤120 chars). It's what Claude reads to
+ *   decide which model to use.
+ * - `useCases` is a small set of short tags (1-3 words) — verbs/nouns Claude
+ *   can match against user intent ("typography", "character", "fast",
+ *   "cinematic"). Stay consistent across entries: don't write "text" in one
+ *   and "typography" in another.
+ * - `aspectRatios` / `resolutions` / `qualities` only appear when the model
+ *   actually exposes that lever (e.g., Nano Banana base has no `resolution`).
+ * - `durations` is in seconds.
+ * - `pricing[0]` is ALWAYS the default variant (the bare id without a
+ *   composite suffix like `:4K` or `:high`).
+ * - Costs are sourced from `STATIC_CREDIT_COSTS` (see backend
+ *   `src/billing/credits.ts`). Keep them in sync if the table changes.
+ * - After editing `MODEL_CATALOG` or `MODEL_RECOMMENDATIONS`, run
+ *   `npm run gen:skills` (from `backend/`) to refresh the public
+ *   `docs/choosing-models.md` guide. CI (`gen:skills:check`) fails on drift.
+ */
+type ModelKind = "image" | "video" | "audio";
+type ModelMode = "t2i" | "i2i" | "edit" | "upscale" | "remove-bg" | "i2v" | "t2v" | "v2v" | "extend" | "motion-transfer" | "lip-sync" | "video-upscale" | "tts" | "music" | "sfx" | "stt" | "voice-clone" | "voice-design" | "voice-changer" | "isolation" | "dubbing" | "forced-alignment" | "dialogue" | "video-analysis" | "video-audit";
+interface PriceVariant {
+    /** Composite identifier as it appears in `STATIC_CREDIT_COSTS`. */
+    identifier: string;
+    /** Credits charged at reservation. */
+    credits: number;
+    /** Short human-readable note describing this variant ("1K default", "4K", "with audio"). */
+    note?: string;
+}
+interface ModelCatalogEntry {
+    id: string;
+    kind: ModelKind;
+    /**
+     * Operations this model supports. Many video models (minimax, veo3,
+     * seedance) support BOTH i2v AND t2v under the same id — the route handler
+     * picks which KIE endpoint to hit based on whether an image was supplied.
+     * For those, list both modes here so MCP filters and frontend pickers see
+     * the model in either context.
+     */
+    modes: readonly ModelMode[];
+    /** Vendor / lab that produced the model. Used for UI grouping. */
+    family: string;
+    /** Display name (NOT the id — the id is the API enum value). */
+    label: string;
+    /**
+     * Model LINE for the add-node Models tab — the brand-agnostic product line a
+     * user thinks in ("Nano Banana", "Flux", "VEO", "Kling", "ElevenLabs").
+     * Distinct from `family` (the lab: Google covers Nano Banana + Imagen + VEO).
+     * REQUIRED for every node-creatable model; a completeness guard in
+     * `@nodaro/shared` (model-tree.test.ts) fails if one is missing.
+     */
+    series?: string;
+    /**
+     * The value written into the creating node's data field when this model is
+     * picked from the Models tab, for models whose catalog id differs from the
+     * stored value. Only `suno-generate` diverges today (id `suno-v5` → `data.model`
+     * "V5"). Omit when the id IS the stored value (the common case).
+     */
+    dataValue?: string;
+    /** One-liner. Visible to Claude in MCP `list_models` output. */
+    description: string;
+    /** Short tags Claude matches against user intent. */
+    useCases: readonly string[];
+    /**
+     * Capabilities flags: "reference-image", "end-frame", "audio", etc.
+     *
+     * `"video-reference"` (video models only) means the model accepts a
+     * reference VIDEO as a CONDITIONING clip — the r2v transport that
+     * `resolveSeedance2Inputs` builds and that KIE receives as
+     * `reference_video_urls`. It is what generate-video-pro's `extend` render
+     * method needs (a continuation tail off the previous segment), and
+     * `GVP_EXTEND_PROVIDERS` derives from it.
+     *
+     * It is deliberately NOT set on `gemini-omni-video`: that model's
+     * `video_list` input is a V2V SOURCE clip with a trim window, an
+     * auto-determined duration and flat per-generation pricing (see
+     * `runGeminiOmni` in `backend/src/providers/kie/video.ts`) — a different
+     * transport, not a continuation reference.
+     */
+    features?: readonly string[];
+    aspectRatios?: readonly string[];
+    resolutions?: readonly string[];
+    /**
+     * What this model actually RENDERS for a resolution outside `resolutions`.
+     *
+     * Most providers honour whatever band they are sent, so an off-list value is
+     * best snapped to the NEAREST supported one — a 4k request on a 1080p-max
+     * model renders 1080p. A few instead COLLAPSE anything unrecognised to a
+     * fixed default (MiniMax H3 → 2K, Wan 3.0 → 720p), and for those the nearest
+     * band is the wrong answer in the most expensive direction: snapping a stale
+     * "720p" to H3's cheap 768P would send a value the provider ignores, so we
+     * would bill the 768P tier against a 2K render, and `commit_credits` never
+     * collects the shortfall.
+     *
+     * Declare it in the catalog's own spelling. `normalizeVideoRequestParams`
+     * uses it in place of the nearest-band snap; `video-collapse-parity.test.ts`
+     * pins each declaration to what the provider normalizer actually returns, so
+     * the two cannot drift.
+     */
+    unlistedResolutionRendersAs?: string;
+    qualities?: readonly string[];
+    durations?: readonly number[];
+    pricing: readonly PriceVariant[];
+    /** Editorial highlight — "best in tier". Surfaces in MCP output as a ⭐. */
+    featured?: boolean;
+    /**
+     * Per-model overrides for the global value label decorations (e.g. Hailuo
+     * 2.3 Pro labels its 1080P resolution as "1080P (6s max)" because the
+     * model caps long durations at lower resolution). Falls back to
+     * `MODEL_VALUE_LABELS` for values not listed here.
+     */
+    valueLabels?: Record<string, string>;
+    /**
+     * Hide from MCP `list_models` output and tool model enums. Used for legacy
+     * model versions superseded by newer entries — they remain in the catalog
+     * (and accessible via direct API / frontend pickers for back-compat) but
+     * stop showing up in Claude.ai's model picker, which keeps the surface
+     * tight and steers the agent to the current generation.
+     *
+     * Frontend pickers ignore this flag.
+     */
+    mcpHidden?: boolean;
+    /**
+     * The provider's safety filter is known to be non-deterministic on this
+     * model — the platform retries a blocked request once; `fallback` names
+     * the catalog model to offer when it blocks again.
+     */
+    safetyFilter?: {
+        stochastic: true;
+        fallback?: string;
+    };
+}
+/**
+ * Editorial recommendations — short "best for X" picks Claude can echo back
+ * to the user when they don't know which model to use. Surfaces as a "Quick
+ * recommendations" footer in MCP `list_models` output.
+ */
+interface ModelRecommendation {
+    intent: string;
+    modelIds: readonly string[];
+    note: string;
+}
+declare const MODEL_RECOMMENDATIONS: readonly ModelRecommendation[];
+declare const MODEL_CATALOG: Record<string, ModelCatalogEntry>;
+/**
+ * Lookup helpers for MCP and the future frontend migration.
+ */
+declare function listModels(filter?: {
+    kind?: ModelKind;
+    mode?: ModelMode;
+    family?: string;
+}): ModelCatalogEntry[];
+/**
+ * Group entries by family, returning a stable order.
+ * Returns Array<{ family: string; models: ModelCatalogEntry[] }>.
+ */
+declare function groupByFamily(entries: ModelCatalogEntry[]): Array<{
+    family: string;
+    models: ModelCatalogEntry[];
+}>;
+declare function getModel(id: string): ModelCatalogEntry | undefined;
+type ValidationField = "aspectRatio" | "resolution" | "quality" | "duration";
+interface ModelValidationIssue {
+    field: ValidationField;
+    message: string;
+    allowed: readonly (string | number)[] | null;
+}
+/**
+ * Validate that the user's lever values are supported by the chosen model.
+ *
+ * Returns null on success or the FIRST issue found. We surface a single issue
+ * rather than collecting all so the agent doesn't get a wall of complaints —
+ * fix one thing, retry. Order: aspectRatio → resolution → quality → duration.
+ *
+ * Semantics:
+ * - If the field is undefined, it's never an issue.
+ * - If the catalog entry doesn't list a corresponding lever (e.g. base
+ *   nano-banana has no `resolutions`), passing that field IS an issue —
+ *   silently dropping it has caused two bugs already.
+ * - If the value is in the allow list, it's valid.
+ *
+ * Unknown model ids are NOT flagged here — the route handler / Zod model
+ * enum is the right gate for that. We just skip validation.
+ */
+declare function validateModelInput(modelId: string, input: {
+    aspectRatio?: string;
+    resolution?: string;
+    quality?: string;
+    duration?: number;
+}): ModelValidationIssue | null;
+/**
+ * The resolution a Flux 2 model should land on when its stored value is absent
+ * or invalid. Flux 2 exposes ascending megapixel options ("0.5 MP"…"4 MP"), so
+ * snapping to `options[0]` would silently downgrade every node to the cheapest
+ * tier; each variant has a sensible mid default instead. Returns undefined for
+ * every non-Flux-2 model (they snap to `options[0]` normally).
+ */
+declare function defaultResolutionFor(modelId: string): string | undefined;
+/** One correction `normalizeModelInput` made, for disclosure to the user. */
+interface ModelInputAdjustment {
+    field: "aspectRatio" | "resolution" | "quality" | "duration";
+    /** The value that was asked for. */
+    from: string | number;
+    /** What it became — `undefined` means the lever was dropped entirely. */
+    to: string | number | undefined;
+    reason: string;
+}
+interface NormalizedModelInput {
+    aspectRatio?: string;
+    resolution?: string;
+    quality?: string;
+    duration?: number;
+    /** Empty when the input was already valid. */
+    adjustments: ModelInputAdjustment[];
+}
+/**
+ * Coerce a model's parameters into a combination the model actually accepts.
+ *
+ * The correcting twin of `validateModelInput`. Validation is right when a
+ * human/agent is composing a single call and can retry (MCP verbs do this).
+ * It is the WRONG answer at a persistence or execution boundary: rejecting
+ * there turns a fixable typo into a failed run — and a failed run takes every
+ * already-generated, already-billed sibling node down with it. Incident
+ * 2026-08-09: one node carrying `gpt-image` + `16:9` (a pair the config panel
+ * cannot produce, written straight into workflow JSON by a non-UI author)
+ * aborted a run whose five other nodes had already produced images.
+ *
+ * Rules, mirroring the config panels' provider-change snap:
+ *  - Model has no such lever → drop the value (sending it 400s upstream).
+ *  - Value outside the model's allow-list → snap to the model's default
+ *    (`defaultResolutionFor`) or the first valid option.
+ *  - Then apply cross-field constraints that only hold for certain models.
+ *
+ * Unknown model ids pass through untouched — the route's Zod model enum is the
+ * right gate for those, exactly as in `validateModelInput`.
+ *
+ * Every correction is reported in `adjustments` so callers can disclose what
+ * changed rather than silently handing back something else.
+ */
+declare function normalizeModelInput(modelId: string, input: {
+    aspectRatio?: string;
+    resolution?: string;
+    quality?: string;
+    duration?: number;
+}): NormalizedModelInput;
+interface NormalizedVideoRequest {
+    aspectRatio?: string;
+    resolution?: string;
+    adjustments: ModelInputAdjustment[];
+}
+/**
+ * The video lane's LIMITED normalizer: `aspectRatio` + `resolution` only, and
+ * only when the catalog actually declares the option list.
+ *
+ * Three deliberate differences from `normalizeModelInput`:
+ *   1. It never DROPS a lever. `normalizeModelInput` removes a value whose list
+ *      the catalog doesn't declare; on the video lane `resolution` is a pricing
+ *      input, so dropping it would lower the reserved tier and `commit_credits`
+ *      never collects an upward delta — a params fix would become a money bug.
+ *   2. "Auto" / "adaptive" pass through (see PASSTHROUGH_ASPECT_TOKENS).
+ *   3. It snaps to the NEAREST option, not to `allowed[0]`. `normalizeModelInput`
+ *      would turn a portrait 9:21 into landscape 16:9 and a 4k request into the
+ *      cheapest 480p; nearest matches what the provider adapters and the MCP
+ *      normalizer already do, so all three give ONE answer. Its snap policy is
+ *      deliberately left alone — it is shared with the image lane and the
+ *      copilot, and PR 4 defers changing it.
+ *
+ * `duration` is deliberately NOT normalized here: the LTX bands make duration
+ * legality resolution-dependent, which a flat catalog list can't express, and
+ * `buildVideoCreditModelIdentifier` already snaps duration onto a seeded tier.
+ * Carrying THAT tier to the wire is `pricedVideoSelection`'s job
+ * (`credit-identifiers.ts`), which runs after this one, once resolution is known.
+ *
+ * An OMITTED lever stays omitted here — filling it is a pricing decision, not a
+ * catalog one, and likewise belongs to `pricedVideoSelection`.
+ *
+ * Case is canonicalised to the catalog's own spelling — the credit identifiers
+ * key their tables case-SENSITIVELY (LTX_DURATION_TIERS), so this is the single
+ * place a "4K" becomes "4k", and it runs before every identifier site.
+ *
+ * Pure — so the credit-identifier preHandler, `computeCredits`, the reservation
+ * site and the payload build can all call it and cannot disagree (spec §4).
+ */
+declare function normalizeVideoRequestParams(modelId: string, input: {
+    aspectRatio?: string;
+    resolution?: string;
+}): NormalizedVideoRequest;
+interface LabeledOption {
+    value: string;
+    label: string;
+}
+/** Return `{value, label}[]` for the model's aspect ratios, or `null` if none. */
+declare function getAspectRatioOptions(modelId: string): LabeledOption[] | null;
+/** Return `{value, label}[]` for the model's resolution lever, or `null` if none. */
+declare function getResolutionOptions(modelId: string): LabeledOption[] | null;
+/** Return `{value, label}[]` for the model's quality lever, or `null` if none. */
+declare function getQualityOptions(modelId: string): LabeledOption[] | null;
+/** Return the model's allowed durations (in seconds), or `null` if none. */
+declare function getDurationsForModel(modelId: string): number[] | null;
+/**
+ * Min/max credits across all pricing variants — used by the frontend's
+ * "5–8 cr" range badge in the model dropdown. `null` for models with a
+ * single price point.
+ */
+declare function getCreditRange(modelId: string): {
+    min: number;
+    max: number;
+} | null;
+/** Whether the model declares a given capability flag in its `features` array. */
+declare function hasFeature(modelId: string, feature: string): boolean;
+/**
+ * All ids in the catalog whose `features` includes the given flag. Used by
+ * frontend to build PROVIDERS_WITH_END_FRAME / PROVIDERS_WITH_REFERENCES
+ * lists derived from the catalog.
+ */
+declare function modelsWithFeature(feature: string): string[];
+/**
+ * Map of `{modelId: durations[]}` for every catalog entry whose `modes`
+ * includes the given mode. Used to derive KIE_VIDEO_DURATIONS (mode i2v)
+ * and KIE_T2V_DURATIONS (mode t2v) on the frontend.
+ */
+declare function durationsByMode(mode: ModelMode): Record<string, number[]>;
+/**
+ * Map of `{modelId: LabeledOption[]}` for every catalog entry of the given
+ * kind that exposes a resolution lever. Used to derive
+ * IMAGE_RESOLUTION_OPTIONS / VIDEO_RESOLUTION_OPTIONS on the frontend.
+ */
+declare function resolutionOptionsByKind(kind: ModelKind): Record<string, LabeledOption[]>;
+/**
+ * Map of `{modelId: LabeledOption[]}` for every catalog entry of the given
+ * kind that exposes an aspect_ratio lever.
+ */
+declare function aspectRatioOptionsByKind(kind: ModelKind): Record<string, LabeledOption[]>;
+/** Same shape as `aspectRatioOptionsByKind` but for `qualities`. */
+declare function qualityOptionsByKind(kind: ModelKind): Record<string, LabeledOption[]>;
+/** One shaped model row for a picker — capabilities derived from the catalog. */
+interface ModelMenuOption {
+    /** Catalog id (the API enum value). */
+    id: string;
+    /** Human-readable display name from the catalog. */
+    label: string;
+    /** Resolution levers, `[]` when the model exposes none. */
+    resolutions: LabeledOption[];
+    /** Aspect-ratio levers, `[]` when the model exposes none. */
+    aspectRatios: LabeledOption[];
+    /** Duration levers in seconds (union of i2v+t2v modes); `[]` for image / fixed-duration models. */
+    durations: {
+        value: number;
+        label: string;
+    }[];
+}
+/**
+ * Build shaped picker rows for one catalog `kind` from a caller-supplied id
+ * allowlist (the curation — which ids, in what order, stays the caller's). Every
+ * CAPABILITY is derived from the catalog accessors, never hardcoded, so the menu
+ * can't drift as the catalog evolves. Ids absent from the catalog or of the
+ * wrong kind are skipped (so a stale allowlist entry drops out cleanly). Pure;
+ * returns fresh arrays (never aliases the accessor maps).
+ */
+declare function buildModelMenu(kind: ModelKind, allowlist: readonly string[]): ModelMenuOption[];
+/** All `{modelId: {min, max}}` entries that have variable pricing (>1 variant). */
+declare function creditRangesAll(): Record<string, {
+    min: number;
+    max: number;
+}>;
+/**
+ * Tuple of model ids for a given kind + one or more modes. Built for use as
+ * a Zod `z.enum()` argument so MCP tool input schemas stay in sync with the
+ * catalog without manual maintenance.
+ *
+ * Filters out `mcpHidden: true` entries by default — pass `includeHidden`
+ * to surface legacy versions (used internally by validators that still need
+ * to recognize older ids forwarded by direct API callers).
+ *
+ * Pass `kind: null` to skip the kind filter — useful for cross-kind ids
+ * like "grok" (catalog kind=image, modes include both t2i and t2v).
+ */
+declare function modelIdsByKindMode(kind: ModelKind | null, modes: readonly ModelMode[], opts?: {
+    includeHidden?: boolean;
+}): [string, ...string[]];
+
 /**
  * Build composite credit model identifiers for variable pricing.
  * Shared between frontend and backend.
  */
+
 /**
  * Compute composite model identifier for variable credit pricing.
  * Examples: "gpt-image:high", "flux:2K", "nano-banana-pro:4K", "ideogram:TURBO",
@@ -1854,7 +2343,57 @@ declare function expandExtraRefsToConnectedReferences(extras: ReadonlyArray<Extr
  * megapixel count plus (Flux 2 Max) the number of reference images attached at request time.
  * For video models, uses duration/sound params when the model has variable pricing.
  */
-declare function buildCreditModelIdentifier(provider: string, quality?: string, resolution?: string, renderingSpeed?: string, targetResolution?: string, referenceImageCount?: number): string;
+declare function buildCreditModelIdentifier(provider: string, quality?: string, resolution?: string, renderingSpeed?: string, targetResolution?: string, referenceImageCount?: number): string;
+/**
+ * An image request's catalog-snapped parameters PLUS the credit identifier
+ * priced off them.
+ *
+ * `adjustments` is the disclosure channel: every lever this changed, why, and
+ * to what. Routes return it in the 200 body so a caller learns their value was
+ * corrected instead of silently getting something else.
+ */
+interface NormalizedImageGen {
+    /** Credit identifier, priced off the SNAPPED `resolution` / `quality`. */
+    identifier: string;
+    /** The catalog model id the params were snapped against (post T2I→I2I swap). */
+    modelId: string;
+    aspectRatio?: string;
+    resolution?: string;
+    quality?: string;
+    /** Empty when the caller's values were already valid for `modelId`. */
+    adjustments: ModelInputAdjustment[];
+}
+/**
+ * Snap an image request's catalog-governed levers to a combination the model
+ * actually accepts, and price the credit identifier off the SNAPPED values.
+ *
+ * WHY THE SNAP LIVES HERE and not at the call site. Both image routes compute
+ * their credit identifier TWICE — once in the `creditGuard` preHandler (the
+ * CHECK) and once at the handler's `reserveCreditsForJob` (the DEBIT) — and a
+ * dedicated test asserts the two stay byte-identical (see
+ * `backend/src/routes/__tests__/generate-image.test.ts`, "CHECK === DEBIT").
+ * `resolution` and `quality` are pricing dimensions, so a snap applied at only
+ * one of those sites breaks that invariant, and `commit_credits` never collects
+ * an upward delta — the reserve IS the charge. Putting the snap inside the
+ * primitive makes CHECK, DEBIT and the workflow orchestrator agree by
+ * construction rather than by everyone remembering to call a normalizer.
+ *
+ * Inputs are typed `unknown` on purpose: the preHandler runs BEFORE Zod, so a
+ * caller can put a number or an object in `resolution`. Non-strings become
+ * `undefined` rather than reaching `normalizeModelInput` as a lie.
+ *
+ * Unknown model ids pass through untouched (same contract as
+ * `normalizeModelInput`) — the route's provider enum is the gate for those.
+ */
+declare function resolveNormalizedImageGen(opts: {
+    provider: string | undefined;
+    aspectRatio?: unknown;
+    quality?: unknown;
+    resolution?: unknown;
+    renderingSpeed?: unknown;
+    refCount: number;
+    swapToI2i?: boolean;
+}): NormalizedImageGen;
 /**
  * Reference-aware image-generation credit identifier — the SINGLE source of
  * truth shared by the single-node routes (`/v1/generate-image`,
@@ -1883,6 +2422,69 @@ declare function resolveImageGenCreditIdentifier(opts: {
     swapToI2i?: boolean;
 }): string;
 declare function buildVideoCreditModelIdentifier(provider: string, duration?: number | string, sound?: boolean, nodeType?: "image-to-video" | "text-to-video", mode?: string, resolution?: string, hasVideoRef?: boolean): string;
+/** What the video credit identifier PRICES for a request, for the levers whose
+ *  priced value must also be the value we SEND. */
+interface PricedVideoSelection {
+    /** The resolution band the reservation is priced at when the request omitted
+     *  one — and only where the platform DECLARES that band as the provider's own
+     *  default. `undefined` means "leave `resolution` exactly as the request had
+     *  it": either the caller supplied one, or the provider's real default is not
+     *  known to be the band the identifier assumes. */
+    resolution?: string;
+    /** The seeded duration tier the reservation is priced at (LTX only — the one
+     *  family whose duration ladder is per-band and case-sensitively seeded).
+     *  `undefined` for every other provider: their duration passes through. */
+    duration?: number;
+    /** Non-empty only for a lever the caller ASKED for and did not get (an LTX
+     *  7s snapped to the 6s tier). Filling an omitted lever is a disclosure of
+     *  the price already being charged, not a correction, so it reports nothing. */
+    adjustments: ModelInputAdjustment[];
+}
+/**
+ * The other half of the video money path: `normalizeVideoRequestParams` snaps a
+ * value the CATALOG governs; this returns the value the PRICE ladder governs.
+ *
+ * Two defects it closes, both of the same shape — the identifier prices one
+ * thing and the wire carries another, and `commit_credits` (migration 176) only
+ * ever refunds a surplus, so the reservation is the final charge:
+ *
+ *  1. **Absent resolution.** `buildVideoCreditModelIdentifier` prices an omitted
+ *     `resolution` as a concrete band (LTX → 1080p; a
+ *     {@link PRICING_DEFAULT_RESOLUTION} member → its declared default). Leaving
+ *     the key unset then lets the provider pick — documented for the KIE members
+ *     (their `extraParams` pin the same band) but UNDOCUMENTED for LTX on
+ *     Replicate. Sending the band we priced makes the two agree by construction.
+ *
+ *     The fill is deliberately limited to providers with a DECLARED default.
+ *     `buildVideoCreditModelIdentifier` also has un-declared fallbacks — the
+ *     cheapest tier for a resolution-priced provider with no
+ *     `PRICING_DEFAULT_RESOLUTION` row — and those are a HEDGE, not a verified
+ *     provider default: seedance-2 / -fast / -mini pin `resolution: "720p"`
+ *     KIE-side while the identifier prices 480p, so filling 480p would downgrade
+ *     the render to match a price we already know is wrong. That mismatch is a
+ *     pre-existing identifier bug and is fixed by seeding the row, not here.
+ *
+ *  2. **LTX duration.** The LTX ladder is seeded per (band × seconds), so the
+ *     identifier snaps 7s onto the 6s tier. Sending 7s bills six and renders
+ *     seven. Most other providers' durations pass through untouched: their
+ *     legality is a flat catalog list the caller already sees, and their tiers
+ *     are ranges (`durationSec <= maxSeconds`), not seeded points. Gemini Omni
+ *     is the one other seeded ladder — `GEMINI_OMNI_DURATIONS` ([4, 6, 8, 10])
+ *     is nearest-snapped by `buildVideoCreditModelIdentifier`, the same shape
+ *     as LTX — but this function does not carry it yet: a 7s request prices
+ *     `:6` while 7s is still what gets sent. Pre-existing, out of scope here,
+ *     and ticketed as a follow-up (`geminiOmniPricedTier`, mirroring
+ *     `ltxPricedTier`).
+ *
+ * Pure, and IDEMPOTENT against the identifier: feeding its output back in
+ * cannot move the reserved tier. `video-request-normalize.test.ts` proves that
+ * over every provider × resolution × duration.
+ */
+declare function pricedVideoSelection(opts: {
+    provider: string;
+    resolution?: string;
+    duration?: number | string;
+}): PricedVideoSelection;
 /**
  * Compute composite model identifier for motion control with duration-tiered pricing.
  * Examples: "kling-3.0-motion:10s", "kling-3.0-motion:1080p:15s", "motion-transfer:5s"
@@ -1895,6 +2497,47 @@ declare function buildVideoCreditModelIdentifier(provider: string, duration?: nu
  * @param videoDuration - Reference video duration in seconds (defaults to 10s, unused for Wan Animate)
  */
 declare function buildMotionCreditModelIdentifier(provider: string, resolution: string, videoDuration?: number): string;
+/**
+ * The Suno operations whose credit key depends on the model VERSION.
+ *
+ * `/v1/suno/generate`, `/cover` and `/extend` resolve their creditGuard
+ * identifier through `sunoCreditType(model, <operation>)` (routes/suno.ts
+ * :247-249, :335-337, :407-409). EVERY other Suno route charges a flat
+ * per-operation key and ignores the version the node carries — mashup (:648),
+ * add-instrumental (:852), add-vocals (:907), upload-extend (:1016),
+ * replace-section (:710), style-boost (:771), convert-wav (:962),
+ * lyrics (:482), music-video (:594), voice (:1218).
+ *
+ * Anything that QUOTES a Suno price — a dropdown row, a node badge, the
+ * workflow-credit estimator — must follow the same split, or it displays a
+ * credit key the route never charges.
+ */
+declare const SUNO_VERSION_PRICED_OPERATIONS: readonly ["suno-generate", "suno-cover", "suno-extend"];
+/**
+ * The seven Suno operations that appear behind a select/dropdown UI (model
+ * pickers, node badges, the credit estimator) — the three version-priced
+ * operations above, plus the four flat-key operations exercised by
+ * `sunoCreditType`'s own test suite. A readonly tuple so later tasks (the
+ * model dropdowns, node badges) can iterate or count it without redeclaring
+ * the list and drifting from this one.
+ */
+declare const SUNO_SELECT_OPERATIONS: readonly ["suno-generate", "suno-cover", "suno-extend", "suno-mashup", "suno-add-instrumental", "suno-add-vocals", "suno-upload-extend"];
+/**
+ * OUR Nodaro credit key for a Suno operation, given the model version and the
+ * operation (which is also the node type and the BullMQ job name).
+ *
+ * This is the single source of truth for the Suno pricing contract, shared by
+ * the reservation path (routes/suno.ts creditGuard), the egress seam
+ * (workers/handlers/suno.ts `modelKey`, which must match what was reserved),
+ * both workflow-credit estimators (ee/billing/credits.ts and the frontend
+ * config-panels/helpers.ts), the seven Suno model dropdowns and the three Suno
+ * node badges. It is a billing key — NEVER a KIE provider id — which is what
+ * satisfies the B3 egress invariant.
+ *
+ * V5_5 → "suno-v5_5", V5 → "suno-v5", any other version → the operation key.
+ * A non-version-priced operation is returned unchanged.
+ */
+declare function sunoCreditType(model: string | undefined, operation: string): string;
 
 /**
  * Pure credit estimators for video-utility nodes (loop-video, trim-video,
@@ -1970,6 +2613,79 @@ declare function assembleNarratedVideoCredits(blockCount: number): number;
  *  (orchestrator input-resolver) can use one source of truth. */
 declare function extractVideoDurationFromNode(data: Record<string, unknown> | undefined): number | undefined;
 
+/**
+ * Topaz image upscale — the single authority for "which lever did the user
+ * pull, what do we send, and what do we charge".
+ *
+ * KIE's `topaz/image-upscale` takes exactly ONE quality lever:
+ *   upscale_factor: "1" | "2" | "4"   (default "2")
+ * There is no target-resolution parameter (docs.kie.ai/market/topaz/image-upscale,
+ * verified 2026-09-02). The editor nevertheless shipped TWO controls — an
+ * `upscaleFactor` select AND a `targetResolution` select (2K/4K/8K) — and billed
+ * on the second one, which never reached the worker. Everyone who bought 4K or
+ * 8K got a 2x render at 2x/4x the price (app-reports triage 2026-09-01 §4.3).
+ *
+ * So: the FACTOR is the lever. `targetResolution` survives only as a legacy
+ * input (stored node data, old API/MCP callers) and is mapped forward here.
+ * The credit tier is derived from the SAME resolution, which is why callers
+ * must pass `creditTier` into `buildCreditModelIdentifier` rather than the raw
+ * request value — that is what makes CHECK = DEBIT = SENT.
+ *
+ * The composite `topaz-image-upscale:4K` is retained as the id of the 4x tier
+ * (migration 288 wrote that row; renaming it would need a pricing migration for
+ * zero user-visible gain). Read it as "the top Topaz tier", not as a promise of
+ * 4096 pixels. `topaz-image-upscale:8K` stays priced in STATIC_CREDIT_COSTS so
+ * historical usage_logs still resolve, but nothing can reserve it any more.
+ *
+ * Resolution order (fix round 1, 2026-09-02 review):
+ *   1. Resolve the WINNING factor first — a valid `upscaleFactor` always wins;
+ *      an invalid one falls through to `targetResolution` exactly as if it had
+ *      never been sent, rather than freezing the default before the legacy
+ *      tier gets a chance to raise it (an invalid factor + a stored 4K/8K tier
+ *      must still resolve — and bill — at the tier's factor, not the default).
+ *   2. Only THEN build `adjustments`, so every `to` reflects the resolved
+ *      factor rather than an intermediate guess, and every `from` is the raw,
+ *      untransformed input string (never the trimmed/uppercased copy used
+ *      internally to match).
+ *   3. A valid `upscaleFactor` alongside a `targetResolution` it disagrees
+ *      with emits an informational (not corrective) adjustment — the stored
+ *      legacy choice is being overridden, not silently dropped — with
+ *      `to: undefined` because nothing was actually sent for that field.
+ *      Agreement (they resolve to the same factor) is reported as nothing:
+ *      there is no override to disclose.
+ */
+type TopazUpscaleFactor = "1" | "2" | "4";
+declare const TOPAZ_UPSCALE_FACTORS: readonly TopazUpscaleFactor[];
+/** KIE's own default when `upscale_factor` is omitted (providers/kie/models.ts). */
+declare const TOPAZ_DEFAULT_UPSCALE_FACTOR: TopazUpscaleFactor;
+interface TopazUpscaleAdjustment {
+    field: "upscaleFactor" | "targetResolution";
+    /** The raw, untransformed value as received — never trimmed or case-normalized. */
+    from: string;
+    /**
+     * The resolved factor this adjustment corresponds to, or `undefined` for the
+     * informational "your stored targetResolution was overridden" notice, which
+     * names nothing to switch TO — `upscaleFactor` already won.
+     */
+    to: string | undefined;
+    reason: string;
+}
+interface TopazUpscaleResolution {
+    /** Sent to KIE as `upscale_factor`. Always set — never rely on the model default. */
+    upscaleFactor: TopazUpscaleFactor;
+    /**
+     * Passed VERBATIM as `buildCreditModelIdentifier`'s `targetResolution` arg.
+     * `undefined` = the bare id (1x / 2x); `"4K"` = the 4x tier.
+     */
+    creditTier: "4K" | undefined;
+    /** Non-empty when a legacy or out-of-enum value was coerced or overridden. */
+    adjustments: TopazUpscaleAdjustment[];
+}
+declare function resolveTopazUpscale(input: {
+    upscaleFactor?: string | null;
+    targetResolution?: string | null;
+}): TopazUpscaleResolution;
+
 interface ExposableField {
     readonly key: string;
     readonly label: string;
@@ -4093,6 +4809,10 @@ declare function canonicalVarName(label: string): string;
  * SUPPRESS auto-injection of a connected node the author already placed
  * explicitly via `{label}` (so it isn't injected twice). `matchAll` over the
  * global pattern does not mutate its lastIndex, so sharing the constant is safe.
+ *
+ * Deliberately NOT `REF_TOKEN_NAMESPACE_PREFIXES`: widening this changes
+ * run-time auto-injection on BOTH engines (follow-up ticket), not just the
+ * editor.
  */
 declare function extractReferencedLabels(...texts: ReadonlyArray<string | undefined | null>): Set<string>;
 /** Handle → combine-order category for same-label `{label}` merging. Lower wins
@@ -4194,6 +4914,55 @@ declare function combineSameLabelRefs(candidates: ReadonlyArray<RefCandidate>):
  * Iterates until stable to handle nested refs (e.g. {List} → {Animal1} → "dog").
  */
 declare function resolveNodeRefs(text: string, labelToOutput: ReadonlyMap<string, string>): string;
+/**
+ * Token namespaces that are NOT node-label references. `{image:1:face}` is the
+ * unified-reference grammar, `{slot:x}` is recast's, `{video:N}`/`{audio:N}`
+ * are reference handles, and `{ref:<id>}` is the id-addressed reference form —
+ * all five are substituted by their own resolvers (`resolveReferenceTokens`,
+ * `resolveRefIdTokens`, the recast slot pass), not by resolveNodeRefs. Before
+ * this list existed, only `image:` was excluded, so `{video:1}` classified as a
+ * MISSING node ref.
+ *
+ * Compared against the LOWERCASED token name: `REFERENCE_TOKEN_RE` is `/gi` and
+ * `REF_ID_TOKEN_RE` spells `[rR][eE][fF]`, so `{Image:1}` / `{Ref:x}` really do
+ * resolve downstream and must never read as a missing node ref.
+ */
+declare const REF_TOKEN_NAMESPACE_PREFIXES: readonly string[];
+type RefTokenKind = "wired" | "reserved" | "missing" | "skip" | "unknown";
+/**
+ * Classify a parsed `{...}` token name against the resolvable label set.
+ * `resolvable === null` means the caller has no ref data at all — such tokens
+ * classify `unknown` and must render like wired, so "no data" never
+ * masquerades as "nothing wired".
+ *
+ * Single source of truth for the editor decoration, the missing-refs chip
+ * (frontend/src/lib/prompt-ref-scan.ts delegates here) and the execution
+ * engine's dispatch guard.
+ */
+declare function classifyRefToken(name: string, resolvable: ReadonlySet<string> | null): RefTokenKind;
+/**
+ * The `{Label}` tokens in `text` that `resolveNodeRefs` would leave LITERAL and
+ * that no upstream node can explain — i.e. exactly what would reach a provider
+ * as the characters `{Label}`. Evidence for why this matters: `{Describe Image}`
+ * ×2 (gpt-image-2) and `{gravity flip}` / `{rewind}` (seedance-2-5) in the
+ * 2026-09-01 app-reports export.
+ *
+ * `resolvable` — labels with a value in the ref map (canonical/lowercase).
+ * `known`      — canonical labels of the nodes the caller considers to EXIST
+ *                (no state requirement; the backend passes every node in the
+ *                run's graph).
+ *
+ * A token whose label is in `known` but not `resolvable` PASSES: the node
+ * exists and simply produced nothing, which is the caller's to substitute (the
+ * backend resolves it to empty text), not this function's to refuse. A token
+ * with an explicit `|| fallback` passes too — the fallback is substituted.
+ * Returns original-cased names, de-duplicated by canonical form, for the
+ * user-facing message.
+ */
+declare function unresolvedRefTokens(text: string, opts: {
+    resolvable: ReadonlySet<string>;
+    known: ReadonlySet<string>;
+}): string[];
 
 /**
  * Follow a list node's `in` edge chain to its effective upstream source.
@@ -4404,392 +5173,95 @@ interface Vehicle {
      * once ("Airship / Dirigible" -> "airship", "Plasma Sword / Lightsaber" ->
      * "plasma sword"). Everywhere else the lowercased label IS the term for a
      * concrete object ("golden retriever", "katana"), so nothing is authored.
-     */
-    readonly term?: string;
-}
-declare const VEHICLES: ReadonlyArray<Vehicle>;
-declare function getVehicle(id: string | undefined | null): Vehicle | undefined;
-declare function getVehicleLabel(id: string | undefined | null, fallback?: string): string;
-declare const VEHICLE_SUBCATEGORY_LABELS: Readonly<Record<VehicleSubcategory, string>>;
-declare const VEHICLE_SUBCATEGORY_ORDER: ReadonlyArray<VehicleSubcategory>;
-
-/**
- * Canonical catalog of weapon presets for the Object entity node.
- *
- * When the Object category is "weapon", users pick a specific weapon from
- * this catalog. The picker auto-fills the object's `objectName` and
- * `description` so the existing `buildObjectPrompt` pipeline just works —
- * no backend prompt changes needed.
- *
- * Organized by weapon family: swords, daggers, axes, polearms, bows,
- * blunt/impact, throwing, modern firearms, historical firearms, explosives
- * & siege, sci-fi, and fantasy.
- */
-type WeaponSubcategory = "swords" | "daggers" | "axes" | "polearms" | "bows" | "blunt" | "throwing" | "firearms-modern" | "firearms-historical" | "explosives-siege" | "sci-fi" | "fantasy";
-interface Weapon {
-    readonly id: string;
-    readonly label: string;
-    readonly subcategory: WeaponSubcategory;
-    readonly description: string;
-    /**
-     * Optional authored compact term — the short phrase a professional would
-     * write in a prompt, as opposed to the user-facing `label` (see the `term`
-     * convention in `@nodaro/prompts`'s `term.ts`). Authored ONLY where the
-     * lowercased label is not that phrase — a UI compound naming two things at
-     * once ("Airship / Dirigible" -> "airship", "Plasma Sword / Lightsaber" ->
-     * "plasma sword"). Everywhere else the lowercased label IS the term for a
-     * concrete object ("golden retriever", "katana"), so nothing is authored.
-     */
-    readonly term?: string;
-}
-declare const WEAPONS: ReadonlyArray<Weapon>;
-declare function getWeapon(id: string | undefined | null): Weapon | undefined;
-declare function getWeaponLabel(id: string | undefined | null, fallback?: string): string;
-declare const WEAPON_SUBCATEGORY_LABELS: Readonly<Record<WeaponSubcategory, string>>;
-declare const WEAPON_SUBCATEGORY_ORDER: ReadonlyArray<WeaponSubcategory>;
-
-/**
- * Multi-select helpers for parameter dimensions that allow up to N picks.
- *
- * A dimension's stored value can be:
- *   - undefined / "" / []  → no pick
- *   - string               → single pick (back-compat with single-select fields)
- *   - string[]             → multi pick (1..N entries)
- *
- * `pickIds` normalizes any of those into a clean string[] (deduped, falsy
- * entries dropped). Pickers cap the array at `maxSelected` (FIFO replacement
- * is the picker's responsibility, not this helper's).
- *
- * Multi-select dimensions today: Person.ethnicity, Mood.mood, Aesthetic.aesthetic.
- */
-declare function pickIds(value: unknown): string[];
-/**
- * Cap a multi-pick array at `maxSelected`, FIFO-replacing the oldest entry
- * when the array is full and a new id is added. Returns a fresh array.
- */
-declare function togglePick(current: ReadonlyArray<string>, id: string, maxSelected: number): string[];
-
-/**
- * Model catalog — single source of truth for what each Nodaro-exposed model
- * is, who made it, what it's good for, and which knobs it accepts.
- *
- * Consumed by:
- * - Backend MCP `list_models` tool (renders the nested per-kind / per-family
- *   response so Claude can pick the right model for a user's intent)
- * - (future) Frontend config panels — today they read parallel registries
- *   in `frontend/src/components/editor/config-panels/model-options.ts`; a
- *   follow-up will migrate them to import from here.
- *
- * Authoring rules:
- * - Keep `description` to one line (≤120 chars). It's what Claude reads to
- *   decide which model to use.
- * - `useCases` is a small set of short tags (1-3 words) — verbs/nouns Claude
- *   can match against user intent ("typography", "character", "fast",
- *   "cinematic"). Stay consistent across entries: don't write "text" in one
- *   and "typography" in another.
- * - `aspectRatios` / `resolutions` / `qualities` only appear when the model
- *   actually exposes that lever (e.g., Nano Banana base has no `resolution`).
- * - `durations` is in seconds.
- * - `pricing[0]` is ALWAYS the default variant (the bare id without a
- *   composite suffix like `:4K` or `:high`).
- * - Costs are sourced from `STATIC_CREDIT_COSTS` (see backend
- *   `src/billing/credits.ts`). Keep them in sync if the table changes.
- * - After editing `MODEL_CATALOG` or `MODEL_RECOMMENDATIONS`, run
- *   `npm run gen:skills` (from `backend/`) to refresh the public
- *   `docs/choosing-models.md` guide. CI (`gen:skills:check`) fails on drift.
- */
-type ModelKind = "image" | "video" | "audio";
-type ModelMode = "t2i" | "i2i" | "edit" | "upscale" | "remove-bg" | "i2v" | "t2v" | "v2v" | "extend" | "motion-transfer" | "lip-sync" | "video-upscale" | "tts" | "music" | "sfx" | "stt" | "voice-clone" | "voice-design" | "voice-changer" | "isolation" | "dubbing" | "forced-alignment" | "dialogue" | "video-analysis" | "video-audit";
-interface PriceVariant {
-    /** Composite identifier as it appears in `STATIC_CREDIT_COSTS`. */
-    identifier: string;
-    /** Credits charged at reservation. */
-    credits: number;
-    /** Short human-readable note describing this variant ("1K default", "4K", "with audio"). */
-    note?: string;
-}
-interface ModelCatalogEntry {
-    id: string;
-    kind: ModelKind;
-    /**
-     * Operations this model supports. Many video models (minimax, veo3,
-     * seedance) support BOTH i2v AND t2v under the same id — the route handler
-     * picks which KIE endpoint to hit based on whether an image was supplied.
-     * For those, list both modes here so MCP filters and frontend pickers see
-     * the model in either context.
-     */
-    modes: readonly ModelMode[];
-    /** Vendor / lab that produced the model. Used for UI grouping. */
-    family: string;
-    /** Display name (NOT the id — the id is the API enum value). */
-    label: string;
-    /**
-     * Model LINE for the add-node Models tab — the brand-agnostic product line a
-     * user thinks in ("Nano Banana", "Flux", "VEO", "Kling", "ElevenLabs").
-     * Distinct from `family` (the lab: Google covers Nano Banana + Imagen + VEO).
-     * REQUIRED for every node-creatable model; a completeness guard in
-     * `@nodaro/shared` (model-tree.test.ts) fails if one is missing.
-     */
-    series?: string;
-    /**
-     * The value written into the creating node's data field when this model is
-     * picked from the Models tab, for models whose catalog id differs from the
-     * stored value. Only `suno-generate` diverges today (id `suno-v5` → `data.model`
-     * "V5"). Omit when the id IS the stored value (the common case).
-     */
-    dataValue?: string;
-    /** One-liner. Visible to Claude in MCP `list_models` output. */
-    description: string;
-    /** Short tags Claude matches against user intent. */
-    useCases: readonly string[];
-    /**
-     * Capabilities flags: "reference-image", "end-frame", "audio", etc.
-     *
-     * `"video-reference"` (video models only) means the model accepts a
-     * reference VIDEO as a CONDITIONING clip — the r2v transport that
-     * `resolveSeedance2Inputs` builds and that KIE receives as
-     * `reference_video_urls`. It is what generate-video-pro's `extend` render
-     * method needs (a continuation tail off the previous segment), and
-     * `GVP_EXTEND_PROVIDERS` derives from it.
-     *
-     * It is deliberately NOT set on `gemini-omni-video`: that model's
-     * `video_list` input is a V2V SOURCE clip with a trim window, an
-     * auto-determined duration and flat per-generation pricing (see
-     * `runGeminiOmni` in `backend/src/providers/kie/video.ts`) — a different
-     * transport, not a continuation reference.
-     */
-    features?: readonly string[];
-    aspectRatios?: readonly string[];
-    resolutions?: readonly string[];
-    qualities?: readonly string[];
-    durations?: readonly number[];
-    pricing: readonly PriceVariant[];
-    /** Editorial highlight — "best in tier". Surfaces in MCP output as a ⭐. */
-    featured?: boolean;
-    /**
-     * Per-model overrides for the global value label decorations (e.g. Hailuo
-     * 2.3 Pro labels its 1080P resolution as "1080P (6s max)" because the
-     * model caps long durations at lower resolution). Falls back to
-     * `MODEL_VALUE_LABELS` for values not listed here.
-     */
-    valueLabels?: Record<string, string>;
-    /**
-     * Hide from MCP `list_models` output and tool model enums. Used for legacy
-     * model versions superseded by newer entries — they remain in the catalog
-     * (and accessible via direct API / frontend pickers for back-compat) but
-     * stop showing up in Claude.ai's model picker, which keeps the surface
-     * tight and steers the agent to the current generation.
-     *
-     * Frontend pickers ignore this flag.
-     */
-    mcpHidden?: boolean;
-}
-/**
- * Editorial recommendations — short "best for X" picks Claude can echo back
- * to the user when they don't know which model to use. Surfaces as a "Quick
- * recommendations" footer in MCP `list_models` output.
- */
-interface ModelRecommendation {
-    intent: string;
-    modelIds: readonly string[];
-    note: string;
-}
-declare const MODEL_RECOMMENDATIONS: readonly ModelRecommendation[];
-declare const MODEL_CATALOG: Record<string, ModelCatalogEntry>;
-/**
- * Lookup helpers for MCP and the future frontend migration.
- */
-declare function listModels(filter?: {
-    kind?: ModelKind;
-    mode?: ModelMode;
-    family?: string;
-}): ModelCatalogEntry[];
-/**
- * Group entries by family, returning a stable order.
- * Returns Array<{ family: string; models: ModelCatalogEntry[] }>.
- */
-declare function groupByFamily(entries: ModelCatalogEntry[]): Array<{
-    family: string;
-    models: ModelCatalogEntry[];
-}>;
-declare function getModel(id: string): ModelCatalogEntry | undefined;
-type ValidationField = "aspectRatio" | "resolution" | "quality" | "duration";
-interface ModelValidationIssue {
-    field: ValidationField;
-    message: string;
-    allowed: readonly (string | number)[] | null;
+     */
+    readonly term?: string;
 }
+declare const VEHICLES: ReadonlyArray<Vehicle>;
+declare function getVehicle(id: string | undefined | null): Vehicle | undefined;
+declare function getVehicleLabel(id: string | undefined | null, fallback?: string): string;
+declare const VEHICLE_SUBCATEGORY_LABELS: Readonly<Record<VehicleSubcategory, string>>;
+declare const VEHICLE_SUBCATEGORY_ORDER: ReadonlyArray<VehicleSubcategory>;
+
 /**
- * Validate that the user's lever values are supported by the chosen model.
- *
- * Returns null on success or the FIRST issue found. We surface a single issue
- * rather than collecting all so the agent doesn't get a wall of complaints —
- * fix one thing, retry. Order: aspectRatio → resolution → quality → duration.
+ * Canonical catalog of weapon presets for the Object entity node.
  *
- * Semantics:
- * - If the field is undefined, it's never an issue.
- * - If the catalog entry doesn't list a corresponding lever (e.g. base
- *   nano-banana has no `resolutions`), passing that field IS an issue —
- *   silently dropping it has caused two bugs already.
- * - If the value is in the allow list, it's valid.
+ * When the Object category is "weapon", users pick a specific weapon from
+ * this catalog. The picker auto-fills the object's `objectName` and
+ * `description` so the existing `buildObjectPrompt` pipeline just works —
+ * no backend prompt changes needed.
  *
- * Unknown model ids are NOT flagged here — the route handler / Zod model
- * enum is the right gate for that. We just skip validation.
- */
-declare function validateModelInput(modelId: string, input: {
-    aspectRatio?: string;
-    resolution?: string;
-    quality?: string;
-    duration?: number;
-}): ModelValidationIssue | null;
-/**
- * The resolution a Flux 2 model should land on when its stored value is absent
- * or invalid. Flux 2 exposes ascending megapixel options ("0.5 MP"…"4 MP"), so
- * snapping to `options[0]` would silently downgrade every node to the cheapest
- * tier; each variant has a sensible mid default instead. Returns undefined for
- * every non-Flux-2 model (they snap to `options[0]` normally).
+ * Organized by weapon family: swords, daggers, axes, polearms, bows,
+ * blunt/impact, throwing, modern firearms, historical firearms, explosives
+ * & siege, sci-fi, and fantasy.
  */
-declare function defaultResolutionFor(modelId: string): string | undefined;
-/** One correction `normalizeModelInput` made, for disclosure to the user. */
-interface ModelInputAdjustment {
-    field: "aspectRatio" | "resolution" | "quality" | "duration";
-    /** The value that was asked for. */
-    from: string | number;
-    /** What it became — `undefined` means the lever was dropped entirely. */
-    to: string | number | undefined;
-    reason: string;
-}
-interface NormalizedModelInput {
-    aspectRatio?: string;
-    resolution?: string;
-    quality?: string;
-    duration?: number;
-    /** Empty when the input was already valid. */
-    adjustments: ModelInputAdjustment[];
+type WeaponSubcategory = "swords" | "daggers" | "axes" | "polearms" | "bows" | "blunt" | "throwing" | "firearms-modern" | "firearms-historical" | "explosives-siege" | "sci-fi" | "fantasy";
+interface Weapon {
+    readonly id: string;
+    readonly label: string;
+    readonly subcategory: WeaponSubcategory;
+    readonly description: string;
+    /**
+     * Optional authored compact term — the short phrase a professional would
+     * write in a prompt, as opposed to the user-facing `label` (see the `term`
+     * convention in `@nodaro/prompts`'s `term.ts`). Authored ONLY where the
+     * lowercased label is not that phrase — a UI compound naming two things at
+     * once ("Airship / Dirigible" -> "airship", "Plasma Sword / Lightsaber" ->
+     * "plasma sword"). Everywhere else the lowercased label IS the term for a
+     * concrete object ("golden retriever", "katana"), so nothing is authored.
+     */
+    readonly term?: string;
 }
+declare const WEAPONS: ReadonlyArray<Weapon>;
+declare function getWeapon(id: string | undefined | null): Weapon | undefined;
+declare function getWeaponLabel(id: string | undefined | null, fallback?: string): string;
+declare const WEAPON_SUBCATEGORY_LABELS: Readonly<Record<WeaponSubcategory, string>>;
+declare const WEAPON_SUBCATEGORY_ORDER: ReadonlyArray<WeaponSubcategory>;
+
 /**
- * Coerce a model's parameters into a combination the model actually accepts.
- *
- * The correcting twin of `validateModelInput`. Validation is right when a
- * human/agent is composing a single call and can retry (MCP verbs do this).
- * It is the WRONG answer at a persistence or execution boundary: rejecting
- * there turns a fixable typo into a failed run — and a failed run takes every
- * already-generated, already-billed sibling node down with it. Incident
- * 2026-08-09: one node carrying `gpt-image` + `16:9` (a pair the config panel
- * cannot produce, written straight into workflow JSON by a non-UI author)
- * aborted a run whose five other nodes had already produced images.
+ * Multi-select helpers for parameter dimensions that allow up to N picks.
  *
- * Rules, mirroring the config panels' provider-change snap:
- *  - Model has no such lever → drop the value (sending it 400s upstream).
- *  - Value outside the model's allow-list → snap to the model's default
- *    (`defaultResolutionFor`) or the first valid option.
- *  - Then apply cross-field constraints that only hold for certain models.
+ * A dimension's stored value can be:
+ *   - undefined / "" / []  → no pick
+ *   - string               → single pick (back-compat with single-select fields)
+ *   - string[]             → multi pick (1..N entries)
  *
- * Unknown model ids pass through untouched — the route's Zod model enum is the
- * right gate for those, exactly as in `validateModelInput`.
+ * `pickIds` normalizes any of those into a clean string[] (deduped, falsy
+ * entries dropped). Pickers cap the array at `maxSelected` (FIFO replacement
+ * is the picker's responsibility, not this helper's).
  *
- * Every correction is reported in `adjustments` so callers can disclose what
- * changed rather than silently handing back something else.
- */
-declare function normalizeModelInput(modelId: string, input: {
-    aspectRatio?: string;
-    resolution?: string;
-    quality?: string;
-    duration?: number;
-}): NormalizedModelInput;
-interface LabeledOption {
-    value: string;
-    label: string;
-}
-/** Return `{value, label}[]` for the model's aspect ratios, or `null` if none. */
-declare function getAspectRatioOptions(modelId: string): LabeledOption[] | null;
-/** Return `{value, label}[]` for the model's resolution lever, or `null` if none. */
-declare function getResolutionOptions(modelId: string): LabeledOption[] | null;
-/** Return `{value, label}[]` for the model's quality lever, or `null` if none. */
-declare function getQualityOptions(modelId: string): LabeledOption[] | null;
-/** Return the model's allowed durations (in seconds), or `null` if none. */
-declare function getDurationsForModel(modelId: string): number[] | null;
-/**
- * Min/max credits across all pricing variants — used by the frontend's
- * "5–8 cr" range badge in the model dropdown. `null` for models with a
- * single price point.
- */
-declare function getCreditRange(modelId: string): {
-    min: number;
-    max: number;
-} | null;
-/** Whether the model declares a given capability flag in its `features` array. */
-declare function hasFeature(modelId: string, feature: string): boolean;
-/**
- * All ids in the catalog whose `features` includes the given flag. Used by
- * frontend to build PROVIDERS_WITH_END_FRAME / PROVIDERS_WITH_REFERENCES
- * lists derived from the catalog.
- */
-declare function modelsWithFeature(feature: string): string[];
-/**
- * Map of `{modelId: durations[]}` for every catalog entry whose `modes`
- * includes the given mode. Used to derive KIE_VIDEO_DURATIONS (mode i2v)
- * and KIE_T2V_DURATIONS (mode t2v) on the frontend.
+ * Multi-select dimensions today: Person.ethnicity, Mood.mood, Aesthetic.aesthetic.
  */
-declare function durationsByMode(mode: ModelMode): Record<string, number[]>;
+declare function pickIds(value: unknown): string[];
 /**
- * Map of `{modelId: LabeledOption[]}` for every catalog entry of the given
- * kind that exposes a resolution lever. Used to derive
- * IMAGE_RESOLUTION_OPTIONS / VIDEO_RESOLUTION_OPTIONS on the frontend.
+ * Cap a multi-pick array at `maxSelected`, FIFO-replacing the oldest entry
+ * when the array is full and a new id is added. Returns a fresh array.
  */
-declare function resolutionOptionsByKind(kind: ModelKind): Record<string, LabeledOption[]>;
+declare function togglePick(current: ReadonlyArray<string>, id: string, maxSelected: number): string[];
+
 /**
- * Map of `{modelId: LabeledOption[]}` for every catalog entry of the given
- * kind that exposes an aspect_ratio lever.
+ * Retry/fallback behavior derived from a catalog entry's `safetyFilter`
+ * flag (see `ModelCatalogEntry.safetyFilter` in `model-catalog.ts`).
  */
-declare function aspectRatioOptionsByKind(kind: ModelKind): Record<string, LabeledOption[]>;
-/** Same shape as `aspectRatioOptionsByKind` but for `qualities`. */
-declare function qualityOptionsByKind(kind: ModelKind): Record<string, LabeledOption[]>;
-/** One shaped model row for a picker — capabilities derived from the catalog. */
-interface ModelMenuOption {
-    /** Catalog id (the API enum value). */
-    id: string;
-    /** Human-readable display name from the catalog. */
-    label: string;
-    /** Resolution levers, `[]` when the model exposes none. */
-    resolutions: LabeledOption[];
-    /** Aspect-ratio levers, `[]` when the model exposes none. */
-    aspectRatios: LabeledOption[];
-    /** Duration levers in seconds (union of i2v+t2v modes); `[]` for image / fixed-duration models. */
-    durations: {
-        value: number;
-        label: string;
-    }[];
+interface SafetyRetryPolicy {
+    /** 2 when the model declares `safetyFilter.stochastic`, else 1. */
+    maxAttempts: 1 | 2;
+    /**
+     * Catalog model id to offer when the retry also blocks. Only present
+     * when the entry declares one AND it resolves to a real catalog entry.
+     */
+    fallback?: string;
 }
 /**
- * Build shaped picker rows for one catalog `kind` from a caller-supplied id
- * allowlist (the curation — which ids, in what order, stays the caller's). Every
- * CAPABILITY is derived from the catalog accessors, never hardcoded, so the menu
- * can't drift as the catalog evolves. Ids absent from the catalog or of the
- * wrong kind are skipped (so a stale allowlist entry drops out cleanly). Pure;
- * returns fresh arrays (never aliases the accessor maps).
- */
-declare function buildModelMenu(kind: ModelKind, allowlist: readonly string[]): ModelMenuOption[];
-/** All `{modelId: {min, max}}` entries that have variable pricing (>1 variant). */
-declare function creditRangesAll(): Record<string, {
-    min: number;
-    max: number;
-}>;
-/**
- * Tuple of model ids for a given kind + one or more modes. Built for use as
- * a Zod `z.enum()` argument so MCP tool input schemas stay in sync with the
- * catalog without manual maintenance.
- *
- * Filters out `mcpHidden: true` entries by default — pass `includeHidden`
- * to surface legacy versions (used internally by validators that still need
- * to recognize older ids forwarded by direct API callers).
+ * The provider's safety filter is known to be non-deterministic on some
+ * catalog models — a benign prompt can trip it once and pass on an
+ * identical retry. For those models the platform retries a blocked
+ * request once (`maxAttempts: 2`) before giving up; `fallback` names the
+ * catalog model to offer the user when the retry also blocks.
  *
- * Pass `kind: null` to skip the kind filter — useful for cross-kind ids
- * like "grok" (catalog kind=image, modes include both t2i and t2v).
+ * Every model not flagged this way — including an unrecognized id —
+ * gets a single attempt and no fallback.
  */
-declare function modelIdsByKindMode(kind: ModelKind | null, modes: readonly ModelMode[], opts?: {
-    includeHidden?: boolean;
-}): [string, ...string[]];
+declare function safetyRetryPolicy(modelId: string): SafetyRetryPolicy;
 
 /**
  * Caption styles for the add-captions node. Static path uses FFmpeg drawtext;
@@ -8974,6 +9446,12 @@ declare function stripTransientRuntimeData<T extends {
  * through mode-dependent defaults (`"adaptive"` for Seedance/Hailuo, duration
  * composites tied to pricing) that this flat normalizer would flatten wrongly;
  * they get their own pass once those defaults are catalog-derived too.
+ *
+ * `modify-image` carries the same provider/aspectRatio/resolution/quality trio
+ * as `image-to-image` (it routes through the same worker), and `edit-image`
+ * carries provider + aspectRatio. `edit-image`'s `targetResolution` is an
+ * UPSCALE target, a different field this module never reads — so listing the
+ * type here heals its ratio without touching what it is priced on.
  */
 declare const MODEL_PARAM_NODE_TYPES: ReadonlySet<string>;
 interface NodeParamAdjustment extends ModelInputAdjustment {
@@ -9808,6 +10286,7 @@ type VideoAnalysisSpeedEffect = (typeof VIDEO_ANALYSIS_SPEED_EFFECTS)[number];
  */
 declare const clipLookSchema: z.ZodObject<{
     style: z.ZodOptional<z.ZodString>;
+    styleId: z.ZodOptional<z.ZodString>;
     grade: z.ZodOptional<z.ZodString>;
     format: z.ZodOptional<z.ZodString>;
     lens: z.ZodOptional<z.ZodString>;
@@ -9861,21 +10340,40 @@ declare const entitySlotSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 type EntitySlot = z.infer<typeof entitySlotSchema>;
+/**
+ * The sound LAYER vocabulary — what kind of thing this layer is.
+ *
+ * `ambience` is deliberately its own member rather than a flavour of `sfx`:
+ * they are different layers of a real mix and they are recreated by different
+ * means — ambience is the continuous bed a scene sits in (room tone, distant
+ * traffic, wind), an sfx is a discrete hit (a door slam, a gunshot). Folded
+ * together, a scene's bed and its one-off noises arrive indistinguishable and
+ * anything recreating the mix has to guess which it was told.
+ *
+ * Exported so a consumer keying its own document by these modes imports the
+ * vocabulary instead of restating it — the same reason every other closed
+ * vocabulary in this file is a const.
+ */
+declare const VIDEO_ANALYSIS_AUDIO_MODES: readonly ["speech", "music", "sfx", "ambience"];
+type VideoAnalysisAudioMode = (typeof VIDEO_ANALYSIS_AUDIO_MODES)[number];
 /**
  * One concurrent sound layer in a scene. Real footage stacks sound (music bed
- * under dialogue over ambient sfx), so a scene carries an ARRAY of these — an
- * empty array means genuine silence. `content`: speech = verbatim words;
- * music/sfx = gen-ready description. `voice` is speech-only voice-casting.
+ * under dialogue over ambient room tone), so a scene carries an ARRAY of these
+ * — an empty array means genuine silence. `content`: speech = verbatim words;
+ * music/sfx/ambience = gen-ready description. `voice` is speech-only
+ * voice-casting.
  */
 declare const audioLayerSchema: z.ZodObject<{
     mode: z.ZodEnum<{
         music: "music";
         sfx: "sfx";
         speech: "speech";
+        ambience: "ambience";
     }>;
     content: z.ZodString;
     voice: z.ZodOptional<z.ZodString>;
     speakerSlot: z.ZodOptional<z.ZodString>;
+    speaker: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type AudioLayer = z.infer<typeof audioLayerSchema>;
 declare const windowSceneSchema: z.ZodObject<{
@@ -9958,10 +10456,12 @@ declare const windowSceneSchema: z.ZodObject<{
             music: "music";
             sfx: "sfx";
             speech: "speech";
+            ambience: "ambience";
         }>;
         content: z.ZodString;
         voice: z.ZodOptional<z.ZodString>;
         speakerSlot: z.ZodOptional<z.ZodString>;
+        speaker: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     slotVariations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
@@ -9971,6 +10471,7 @@ declare const windowAnalysisSchema: z.ZodObject<{
     language: z.ZodOptional<z.ZodString>;
     look: z.ZodOptional<z.ZodObject<{
         style: z.ZodOptional<z.ZodString>;
+        styleId: z.ZodOptional<z.ZodString>;
         grade: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
         lens: z.ZodOptional<z.ZodString>;
@@ -10081,10 +10582,12 @@ declare const windowAnalysisSchema: z.ZodObject<{
                 music: "music";
                 sfx: "sfx";
                 speech: "speech";
+                ambience: "ambience";
             }>;
             content: z.ZodString;
             voice: z.ZodOptional<z.ZodString>;
             speakerSlot: z.ZodOptional<z.ZodString>;
+            speaker: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         slotVariations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>>;
@@ -10170,10 +10673,12 @@ declare const analyzedSceneSchema: z.ZodObject<{
             music: "music";
             sfx: "sfx";
             speech: "speech";
+            ambience: "ambience";
         }>;
         content: z.ZodString;
         voice: z.ZodOptional<z.ZodString>;
         speakerSlot: z.ZodOptional<z.ZodString>;
+        speaker: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     slotVariations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     sceneNumber: z.ZodNumber;
@@ -10193,6 +10698,7 @@ declare const videoAnalysisResultSchema: z.ZodObject<{
     }, z.core.$strip>;
     look: z.ZodOptional<z.ZodObject<{
         style: z.ZodOptional<z.ZodString>;
+        styleId: z.ZodOptional<z.ZodString>;
         grade: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
         lens: z.ZodOptional<z.ZodString>;
@@ -10303,10 +10809,12 @@ declare const videoAnalysisResultSchema: z.ZodObject<{
                 music: "music";
                 sfx: "sfx";
                 speech: "speech";
+                ambience: "ambience";
             }>;
             content: z.ZodString;
             voice: z.ZodOptional<z.ZodString>;
             speakerSlot: z.ZodOptional<z.ZodString>;
+            speaker: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         slotVariations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         sceneNumber: z.ZodNumber;
@@ -10361,7 +10869,7 @@ declare function rewriteSpeakerSlots(audio: AudioLayer[], slotRenames: Record<st
  * Strip attribution that no scene can honour — the `dropUnknownBindings` mirror
  * for the `audio` channel. Two cases, both model sloppiness rather than errors
  * worth failing a roll over:
- *   - a `speakerSlot` on a `music`/`sfx` layer (nobody is speaking)
+ *   - a `speakerSlot` on any non-`speech` layer (nobody is speaking)
  *   - a `speakerSlot` naming a slot that is not in the final list
  *
  * MUST run AFTER the orphan-slot sweep, and attribution must NEVER count as a
@@ -10423,6 +10931,19 @@ declare function inferMusicVideo(analysis: {
         }>;
     }>;
 } | undefined | null): boolean;
+/**
+ * The analysis with its server-derived fields removed — the form an LLM is
+ * handed when the analysis IS the brief (Nodaro Studio's Director and its
+ * job-id loader). Drops `warnings` and `variationFolds` at the top and
+ * `visualResolved`, `slotRefs`, `oversized` on every scene; keeps
+ * `refImageUrl` (a downstream cast image) and everything else. Never mutates;
+ * a non-object input comes back as-is.
+ *
+ * ONE strip list, shared by the worker that composes the brief server-side
+ * (`llm-structured` jobs with a `videoUrl`) and the client that loads a
+ * finished analysis into a textarea, so the two can never drift.
+ */
+declare function stripDerivedAnalysisFields(json: unknown): unknown;
 
 /**
  * Video-analysis pricing — shared duration-bucket credit model.
@@ -10745,12 +11266,21 @@ declare const GRANTED_ACCESS: readonly ["view", "edit"];
 type GrantedAccess = (typeof GRANTED_ACCESS)[number];
 declare const SUBMISSION_STATUSES: readonly ["submitted", "in_review", "returned", "approved"];
 type SubmissionStatus = (typeof SUBMISSION_STATUSES)[number];
+/**
+ * How a usage report is bucketed. `workspace` is org-scope only; `none`
+ * = flat rows. A runtime list, like `ORG_ROLES`, so the plugin route's Zod is
+ * `z.enum(USAGE_GROUP_BYS)` and the migration guard asserts the SQL
+ * `NOT IN (...)` list equals this minus `none` — one vocabulary, never three
+ * hand-copies that drift.
+ */
+declare const USAGE_GROUP_BYS: readonly ["workspace", "member", "model", "day", "none"];
+type UsageGroupBy = (typeof USAGE_GROUP_BYS)[number];
 /**
  * Error codes the organization endpoints add to the standard envelope
  * (`{ error: { code, message } }`). Clients dispatch on the code, never on
  * the message text.
  */
-declare const ORG_ERROR_CODES: readonly ["not_a_member", "insufficient_role", "org_not_active", "member_suspended", "workspace_archived", "personal_space_disabled", "token_workspace_mismatch", "run_requires_authenticated_member", "budget_exceeded", "member_cap_exceeded", "model_not_allowed", "invitation_expired", "invitation_revoked", "email_mismatch", "join_code_invalid", "domain_not_allowed", "already_started", "collab_unavailable", "terms_required", "not_org_member", "already_a_member", "owner_cannot_leave", "has_active_workspaces", "invitation_not_found", "invitation_accepted", "bulk_invite_cap_exceeded"];
+declare const ORG_ERROR_CODES: readonly ["not_a_member", "insufficient_role", "org_not_active", "member_suspended", "workspace_archived", "personal_space_disabled", "token_workspace_mismatch", "run_requires_authenticated_member", "budget_exceeded", "member_cap_exceeded", "model_not_allowed", "invitation_expired", "invitation_revoked", "email_mismatch", "join_code_invalid", "domain_not_allowed", "already_started", "collab_unavailable", "audit_unavailable", "terms_required", "not_org_member", "already_a_member", "owner_cannot_leave", "has_active_workspaces", "invitation_not_found", "invitation_accepted", "bulk_invite_cap_exceeded"];
 type OrgErrorCode = (typeof ORG_ERROR_CODES)[number];
 /**
  * The settings every organization kind has a default for. `organizations.
@@ -11027,6 +11557,133 @@ interface OrgPage<T> {
     data: T[];
     nextCursor: string | null;
 }
+/**
+ * Usage reporting. What `GET /v1/orgs/:id/usage` and
+ * `GET /v1/workspaces/:id/usage` return. No cost/USD field appears anywhere —
+ * a report shows CREDITS a class or team spent, never the platform's own rates
+ * (pricing-leak class, guarded by organizations-types.test.ts and the
+ * migration guard).
+ */
+/** One bucket of a usage report. Exactly one of workspace/member/model/day is set. */
+interface UsageReportRow {
+    key: string;
+    workspace: {
+        id: string;
+        name: string | null;
+        slug: string | null;
+        archived: boolean;
+    } | null;
+    member: {
+        userId: string;
+        displayName: string | null;
+        email: string | null;
+    } | null;
+    model: string | null;
+    /** `YYYY-MM-DD` in the report's `tz`. */
+    day: string | null;
+    runCount: number;
+    appRunCount: number;
+    /** Settled where known, the held reservation otherwise. = settledCredits + inFlightCredits. */
+    credits: number;
+    settledCredits: number;
+    inFlightCredits: number;
+    inFlightRuns: number;
+}
+/**
+ * A platform-absorbed line for one workspace, split by ORIGIN (never attributed
+ * to a member). Two ledgers share the `org_usage_variance` source: a
+ * `metered_overrun` (a metered run's overrun beyond the budget — it HAS a
+ * settled usage_logs counterpart) and an `app_markup` shortfall (an
+ * approved-app markup the budget could not cover — it has NO usage_logs row).
+ * `other` is a future/unrecognised origin.
+ */
+interface UsageVarianceRow {
+    workspace: {
+        id: string;
+        name: string | null;
+        slug: string | null;
+    } | null;
+    kind: "metered_overrun" | "app_markup" | "other";
+    credits: number;
+    rowCount: number;
+}
+/**
+ * Totals over the WHOLE window — every usage_logs row in [from, to] after the
+ * scope / userId / workspaceId narrowing — never over the returned `rows`.
+ * Unaffected by `truncated`; equals a `groupBy=day` report's column-wise sum.
+ */
+interface UsageReportTotals {
+    runCount: number;
+    credits: number;
+    settledCredits: number;
+    inFlightCredits: number;
+    /** Metered-overrun variance in the window — a run's overrun the platform absorbed. */
+    platformAbsorbedCredits: number;
+    /** Approved-app markup shortfall the platform absorbed. It has NO usage_logs run, so it is not in the figures above. */
+    appMarkupAbsorbedCredits: number;
+    /**
+     * settledCredits − platformAbsorbedCredits: the METERED settlement that
+     * reached the workspace budget(s). App markup charged to a budget (migration
+     * 352) is not a usage_logs row and is not included here; when a markup
+     * shortfall is absorbed this figure under-reports and may go negative — it is
+     * NOT `workspace_budgets.spent_credits`.
+     */
+    chargedToBudget: number;
+}
+interface UsageReport {
+    scope: "org" | "workspace";
+    scopeId: string;
+    from: string;
+    to: string;
+    tz: string;
+    groupBy: Exclude<UsageGroupBy, "none">;
+    /** Present when a member's self-view or an admin's `?userId=` narrowed the report. */
+    userId: string | null;
+    /** Present when an org report was narrowed to one workspace. */
+    workspaceId: string | null;
+    rows: UsageReportRow[];
+    variance: UsageVarianceRow[];
+    totals: UsageReportTotals;
+    /**
+     * True when more than 5000 buckets existed and the tail of `rows` was dropped
+     * — narrow the window. Only `rows` is incomplete; `totals` and `variance`
+     * cover the whole window regardless.
+     */
+    truncated: boolean;
+}
+/** One usage_logs row as an organization sees it. No cost fields, ever. */
+interface UsageLogEntry {
+    id: string;
+    createdAt: string;
+    workspace: {
+        id: string;
+        name: string | null;
+        slug: string | null;
+    } | null;
+    member: {
+        userId: string;
+        displayName: string | null;
+        email: string | null;
+    } | null;
+    jobId: string | null;
+    model: string;
+    status: "reserved" | "committed";
+    creditsReserved: number;
+    creditsSettled: number | null;
+    credits: number;
+    isAppRun: boolean;
+}
+/** Query parameters shared by both usage routes (dates inclusive, IANA tz). */
+interface UsageQuery {
+    from?: string;
+    to?: string;
+    tz?: string;
+    groupBy?: UsageGroupBy;
+    workspaceId?: string;
+    userId?: string;
+    cursor?: string;
+    limit?: number;
+}
 
 /**
  * Which DB columns of a saved entity land on its canvas node, per kind.
@@ -11095,4 +11752,4 @@ declare function entityHydrationColumns(kind: EntityNodeKind): string[];
 /** Every scalar `kind` actually has, shared plus its own. */
 declare function entityScalarFields(kind: EntityNodeKind): ReadonlyArray<readonly [string, string]>;
 
-export { ACCESS_LEVELS, ACTIVE_SCENE_HELPERS, ADVANCED_MODE_UNAVAILABLE_REASON, AGGREGATEABLE_TYPES, AGGREGATE_LANE_SOURCE_TYPES, AI_AVATAR_DURATION_BUCKETS, AI_AVATAR_MAX_AUDIO_SEC, AI_AVATAR_MAX_DURATION_SEC, AI_AVATAR_RESERVE_IDS, AI_WRITER_PROVIDERS, ALA_CARTE_BOARDS, ALL_CAPTION_STYLES, ANIMALS, ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, ASPECT_RATIO_DIMENSIONS, AUDIO_ADDON_PROVIDERS, AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, AUDIO_PRODUCER_TYPES, type AccessLevel, type AddBRollResult, AddBRollResultSchema, type AggregateableType, type AggregationBuckets, type AiAvatarDurationBucket, type AiAvatarEngine, type AiAvatarResolution, type AiWriterProvider, type AlaCarteBoard, type AnalyzedScene, type AnchorSceneStyleResult, AnchorSceneStyleResultSchema, type Animal, type AnimalSubcategory, type AssetRef, AssetRefSchema, type AudioCrossfadeCurve, type AudioFxPreset, type AudioLayer, type AuditImagesResult, AuditImagesResultSchema, type AuditImagesShotEntry, AuditImagesShotEntrySchema, AuditPromptIssueSchema, type AuditPromptResult, AuditPromptResultSchema, AvatarPayloadError, BOARD_TO_ASSET_TYPE, BOARD_TO_COLUMN, BOARD_VARIANTS, type BoardEntityKind, type BoardPromptContext, type BoardTemplate, BridgeToNextSceneInputSchema, type BridgeToNextSceneResult, BridgeToNextSceneResultSchema, type BrowseCommunityParams, type BrowseCommunityResult, CATEGORY_DURATION_DEFAULTS, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASSET_TYPES, CHARACTER_ASSET_VARIANTS, CHARACTER_ATTACH_COLUMNS, CHARACTER_FACETS, CHARACTER_FACET_IDS, CHARACTER_LORA_TRAINING_JOB_TYPE, CHARACTER_MOTION_PROVIDERS, CHARACTER_PICKER_DISPLAY_ORDER, CHARACTER_REFERENCE_PHOTO_KINDS, CHARACTER_STYLES, CHARACTER_VARIANT_ASSET_BUCKETS, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, CINEMATIC_DEFAULT_DURATION_SEC, CINEMATIC_DEFAULT_RESOLUTION, CINEMATIC_MAX_DURATION_SEC, CINEMATIC_MAX_LOOKS, CINEMATIC_MAX_REFERENCE_IMAGES, CINEMATIC_MAX_REFERENCE_VIDEOS, CINEMATIC_MIN_DURATION_SEC, CINEMATIC_MIN_LOOKS, CINEMATIC_PROMPT_MAX, CINEMATIC_RESERVE_IDS, COLLABORATOR_ROLES, COLLECT_IN_HANDLE, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, COMPOSER_PLAN_FIELDS, COMPOSER_PLAN_MAP, CONTENT_TYPES_BY_PLATFORM, CREATURE_ATTACH_COLUMNS, CREDIT_BASE_USD, CREDIT_ROUNDING_RESOLUTION, type CaptionStyle, type CastCoverageCriticVerdict, CastCoverageCriticVerdictSchema, type CharacterAspectRatio, type CharacterAssetType, type CharacterAssetTypeForAspect, type CharacterAttachColumn, type CharacterDef, type CharacterFacet, type CharacterImageCriticVerdict, CharacterImageCriticVerdictSchema, type CharacterLoraFields, type CharacterMentionTokenInfo, CharacterMetadataSchema, type CharacterMotionProvider, type CharacterReferencePhoto, type CharacterReferencePhotoKind, type CharacterVariantAssetBucket, type CharacterVariantAssetItem, type CharacterVoiceSpec, type ChatEnabledStage, type ChatTurnResponse, ChatTurnResponseSchema, type CinematicResolution, type ClipLook, type CloneListingResult, type CollaboratorRole, type CombineTransition, type CombineTransitionGroup, type CombineVideosEstimatorInput, type CommunityCard, type CommunityEntityType, type CommunityFullDetail, type CommunityReportReason, type CommunitySort, type ComponentHandle, type ComponentMetadata, type ConnectedReference, type CreatureAttachColumn, CriticIssueSchema, type CustomEntry, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, DEFAULT_CARRIED_FRACTION, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, DEFAULT_CHARACTER_FACET, DEFAULT_LABEL_BY_SOURCE, DEFAULT_LOCATION_USAGE_MODE, DEFAULT_PANEL_COUNT, DEFAULT_REF_IMAGE_MAX, DEFAULT_SECTIONS, DEFAULT_USAGE_MODE, DEFAULT_VIDEO_ANALYSIS_MODEL, DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_CLIP_COST, DEFAULT_VIDEO_DURATION_SEC, DEFAULT_VIDEO_PROVIDER, DEFAULT_VOICE_CHANGER_MODEL, DEFAULT_VOICE_DESIGN_MODEL, DETAIL_VARIANTS, DURATION_PRICED_PROVIDERS, DYNAMIC_PRODUCER_TYPES, type DetectionResult, DetectionResultSchema, type DialogueLine, EFFORT_TIER_BUMP, EMOTIONAL_BEAT, ENTITY_ASPECT_DEFAULTS, ENTITY_BUCKET_FIELDS, ENTITY_DB_ID_FIELD, ENTITY_IMAGE_HANDLE_TYPES, ENTITY_KIND_SCALAR_FIELDS, ENTITY_NAME_FIELD, ENTITY_NODE_KINDS, ENTITY_SCALAR_FIELDS, ENTITY_SECTIONS, ENTITY_STATUSES, ENTITY_TABLE, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, EXECUTION_DATA_KEYS, EXTEND_VIDEO_PROVIDERS, type EntityKind, type EntityMentionTokenInfo, type EntityMetadata, EntityMetadataSchema, type EntityNodeKind, type EntityReferenceInput, type EntityRejectInput, EntityRejectInputSchema, type EntitySlot, type EntityStaleEvent, EntityStaleEventSchema, type EntityStateChangeEvent, EntityStateChangeEventSchema, type EntityStatus, type EntityStudioKind, type EntityStyle, type EntityType, type EvaluateConditionOptions, type ExportedPreset, type ExposableField, type ExposableOutput, type ExposedSetting, type ExtendVideoProvider, type ExtraRefCharacterContext, type ExtraRefInput, FACE_SWAP_PROVIDERS, FAL_LIP_SYNC_PROVIDERS, FAN_OUT_EACH_TYPES, FEATURED_ENTITIES, FILM_BASE_CREDITS, FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS, FLUX2_RES_MP, FLUX_LORA_CHARACTER_MODEL_ID, FRAME_MODE_ADAPTIVE_ONLY_ASPECT, FRAME_TARGET_HANDLES, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, FURNITURE, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, type FaceSwapProvider, type FavoriteListingResult, type FeaturedEntity, type FilmCreditEstimate, type FilterListCondition, type FilterListOperator, type FilterOperator, type FixContinuityInput, FixContinuityInputSchema, type FixContinuityResult, FixContinuityResultSchema, type Flux2Model, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, type FullSelectorMode, type Furniture, type FurnitureSubcategory, GEMINI_OMNI_PROVIDERS, GENERATE_TEXT_DELIMITER, GLOBAL_MAX_DURATION_SECONDS, GRANTED_ACCESS, GROUP_HANDLE_PREFIX, GUIDANCE_SCALE_SUPPORT, GVP_ANCHOR_CHOICES, GVP_DEFAULT_PROVIDER, GVP_END_FRAME_PROVIDERS, GVP_EXTEND_PROVIDERS, GVP_SUPPORTED_PROVIDERS, GenerateMotionInputSchema, type GenerateMotionResult, GenerateMotionResultSchema, type GenericEdge, type GenericNode, type GrantedAccess, type GvpAnchorChoice, type GvpAnchorWireMode, HANDLE_PORT_SEPARATOR, HELPERS_SHIPPED_IN_1B3, HIGH_QUALITY_PROVIDERS, HINT_EXEMPT_PARAMETER_TYPES, type HintEdgeLike, type HintGraphContext, type HintNodeLike, type I18nCatalogId, I2I_MASK_SUPPORT, I2I_STRENGTH_SUPPORT, IDEOGRAM_PROVIDERS, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, IMAGE_EDIT_PROVIDERS, IMAGE_GEN_PROVIDERS, IMAGE_I2I_PROVIDERS, IMAGE_MASK_MODE, IMAGE_PROMPT_MAX, IMAGE_REF_TYPES, IMAGE_TO_VIDEO_PROVIDERS, INPUT_FIELD_MAP, INPUT_NODE_TYPES, INSTAGRAM_CAROUSEL_MAX_ITEMS, INSTAGRAM_CAROUSEL_MIN_ITEMS, ITER_CLONE_PATTERN, type IdentityFidelity, type IdentityMeta, type ImageCriticIssue, ImageCriticIssueSchema, type ImageCriticLeafMode, type ImageCriticMetadataKey, type ImageCriticMode, type ImageCriticNodeIssue, type ImageCriticResult, ImageCriticResultSchema, type ImageCriticVerdict, ImageCriticVerdictSchema, type ImageEditProvider, type ImageGenProvider, type ImageI2IProvider, type ImageMaskMode, type ImageMentionTokenInfo, type ImageToVideoProvider, type ImprovePromptInput, ImprovePromptInputSchema, type ImprovePromptResult, ImprovePromptResultSchema, type InputFieldSchema, type InvitationDelivery, type InvitationPreview, type InvitationState, type InvitationView, type JoinCodeView, type JsonEvalResult, type JsonFilter, type JsonPatch, KEYFRAME_CREDITS_PER_SHOT, KINETIC_CAPTION_STYLES, type KieApiFormat, type KineticCaptionStyle, LANGUAGES, LEGACY_LOTTIE_HOST_REMAP, LIP_SYNC_DURATION_BUCKETS, LIP_SYNC_MAX_AUDIO_SECONDS, LIP_SYNC_PROVIDERS, LLM_FEATURE_DEFAULTS, LLM_MODALITY_CAPS, LLM_MODELS, LLM_MODEL_IDS, LLM_REASONING_EFFORTS, LLM_ROUTE_DEFAULTS, LLM_TEXT_INPUT_MAX, LLM_VENDOR_LABELS, LLM_VENDOR_ORDER, LOCATION_ASSET_TYPES, LOCATION_ASSET_VARIANTS, LOCATION_ATMOSPHERE_PROVIDERS, LOCATION_ATTACH_COLUMNS, LOCATION_BUCKET_TO_CATALOG_ID, LOCATION_PRESET_TO_CATALOG, LOCATION_REFERENCE_PHOTO_KINDS, LOCATION_REFERENCE_PHOTO_KIND_LABELS, LOCATION_USAGE_MODES, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LabeledOption, type LipSyncDurationBucket, type LipSyncProvider, type LlmFeature, type LlmModelDef, type LlmModelGroup, type LlmReasoningEffort, type LlmRouteDefaults, type LlmTier, type LlmVendor, type LocaleCatalogMap, type LocaleDirection, type LocaleId, type LocationAssetType, type LocationAtmosphereProvider, type LocationAttachColumn, type LocationCatalogRef, type LocationImageCriticVerdict, LocationImageCriticVerdictSchema, type LocationMentionTokenInfo, LocationMetadataSchema, type LocationReferencePhotoKind, type LocationUsageMode, LocationsCoverageCriticIssueSchema, type LocationsCoverageCriticVerdict, LocationsCoverageCriticVerdictSchema, type LoopTrimEstimatorInput, type LoopVideoEstimatorInput, type LoraEligibleRef, type LoraRouting, type LottieOverlayCatalogEntry, type LottieSlotField, MAX_CUSTOM_ENTRIES_PER_BOARD, MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER, MAX_LOCATION_VARIANTS, MAX_NEGATIVE_PROMPT_CHARS_BY_PROVIDER, MAX_PANELS_PER_SHEET, MAX_TTS_CHARS_BY_PROVIDER, MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER, MEMBER_STATUSES, MINIMAX_H3_DEFAULT_RESOLUTION, MINIMAX_H3_PROVIDERS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, MODEL_CATALOG, MODEL_PARAM_NODE_TYPES, MODEL_RECOMMENDATIONS, MODIFY_IMAGE_PROVIDERS, MOTION_COLUMN, MOTION_TRANSFER_PROVIDERS, MUSIC_PROVIDERS, type MaskRegionDescriptor, type MatchCutVerdict, MatchCutVerdictSchema, type MeOrganizations, type Member, type MemberStatus, type MinimalEdge, type MinimalNode, type ModelCatalogEntry, type ModelInputAdjustment, type ModelKind, type ModelMenuOption, type ModelMode, type ModelNodeTarget, type ModelPromptingStyle, type ModelRecommendation, type ModelTreeLine, type ModelTreeVariant, type ModelValidationIssue, type ModifyImageProvider, type MotionTransferProviderType, type MusicProvider, NATIVE_ADAPTIVE_ASPECT, NATIVE_NEGATIVE_PROMPT_MODELS, NATIVE_NEGATIVE_VIDEO_PROVIDERS, NEGATIVE_PROMPT_MAX, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, NODE_DEFAULT_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_REF_PATTERN, NON_EN_LOCALE_IDS, NO_SPLIT_DELIMITER, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, type NodeDefaultType, type NodeParamAdjustment, type NodePresetExport, type NormalizedModelInput, type NormalizedNodes, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ASSET_VARIANTS, OBJECT_ATTACH_COLUMNS, OBJECT_MOTION_PROVIDERS, OBJECT_PICKER_NODE_TYPES, ORG_ERROR_CODES, ORG_KINDS, ORG_ROLES, ORG_STATUSES, OUTPUT_FIELD_MAP, OUTPUT_FORMATS, type ObjectAspectRatio, type ObjectAssetType, type ObjectAssetTypeForAspect, type ObjectAttachColumn, ObjectMetadataSchema, type ObjectMotionProvider, type ObjectsValidationIssue, type ObjectsValidationResult, OptimizeForModelInputSchema, type OptimizeForModelResult, OptimizeForModelResultSchema, type OrgAuditEntry, type OrgErrorCode, type OrgKind, type OrgMemberView, type OrgPage, type OrgRole, type OrgSettings, OrgSettingsSchema, type OrgStatus, type OrganizationSummary, type OrganizationView, type OutputFormat, type OutputMode, type OutputType, PARAMETER_NODE_TYPES, PASSTHROUGH_TYPES, PAYG_RETENTION_DAYS, PER_FORMAT_DURATION_BOUNDS, PICKER_TO_COMBINE_TRANSITION, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, PLACEHOLDER_CHARACTER_NAME, PLATFORM_LABELS, PLATFORM_SPECS, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LABELS, PRESET_SETTING_KEYS, PRICING_DEFAULT_DURATION_SEC, PRICING_DEFAULT_RESOLUTION, PROMPT_HARD_CEILING, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PROVIDER_DIRECTIVE_DEFAULTS, PROVIDER_PLACEHOLDER_PREFIX, type PanelGenRequest, type PanelRequest, type PanelSource, type PipelineActivationMode, type PipelineCompletedEvent, PipelineCompletedEventSchema, type PipelineConfig, PipelineConfigSchema, type PipelineDriftSummary, PipelineDriftSummarySchema, type PipelineEditorDecisionsReadyEvent, PipelineEditorDecisionsReadyEventSchema, type PipelineEvent, type PipelineForkedEvent, PipelineForkedEventSchema, type PipelineFormat, type PipelineInput, PipelineInputSchema, type PipelineLifecycleEvent, type PipelineMode, type PipelineModelStage, type PipelineMusicReadyEvent, PipelineMusicReadyEventSchema, type PipelineOutputResolution, type PipelinePinnableImageModel, type PipelinePinnableScriptLlm, type PipelinePinnableVideoModel, type PipelineStageName, PipelineStageNameSchema, type PipelineStageStatus, PipelineStageStatusSchema, type PipelineState, PipelineStateSchema, type PipelineStatus, PipelineStatusSchema, type PipelineType, type PixelBox, type PresentationItem, type PresetEntry, type PresetSettingKey, type PresetSettings, PresetSettingsSchema, type PriceVariant, type ProgressSegment, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type PromptAffixFields, type PromptAffixes, type ProposedChange, type PublishListingParams, type PublishListingResult, QA_CHECK_PROVIDERS, type QaCheckProvider, type QualityLevel, REDUCE_STRATEGIES, REDUCE_STRATEGY_IDS, REFERENCE_BOARD_PROVIDERS, REFERENCE_BOARD_TEMPLATES, REFERENCE_HANDLE_MAP, REFERENCE_ROLE_PRESETS, REF_HANDLE_CATEGORY, REF_IMAGE_MAX_LIMITS, RENDERING_SPEED_SUPPORT, REPEATABLE_NODE_TYPES, REPEAT_PLACEHOLDER, REPLICATE_LIP_SYNC_PROVIDERS, RESERVED_TEMPLATE_VARS, type ReduceMeta, type ReduceStrategy, type ReduceStrategyId, type RefCandidate, type RefModalityEdge, type ReferenceBoardProvider, type ReferenceModality, type ReferenceSheet, type ReferenceSource, type ReportListingResult, type ResolveCharacterAspectOptions, type ResolveObjectAspectOptions, type ResolveSeparatorOptions, type ResolvedDialogueVoiceLine, type RouterConditionGroup, SCENE_HELPER_NAMES, SCRAPER_ACTOR_LABELS, SCRAPER_CREDIT_COSTS, SCRAPER_OUTPUT_FIELDS, SCRIPT_PROVIDERS, SEASONS, SECTION_BOARD, SECTION_KINDS, SEEDANCE_2_5_REF_LIMITS, SEEDANCE_2_CONTINUATION_REF_SEC, SEEDANCE_2_EXTEND_STITCH, SEEDANCE_2_PROVIDERS, SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER, SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC, SEEDANCE_2_REF_LIMITS, SEEDANCE_LIP_SYNC_PROVIDERS, SEED_SUPPORT, SEPARATOR_DISPLAY, SEPARATOR_PRESETS, SHEET_ASPECTS, SHEET_BACKGROUNDS, SHEET_PRESETS, SHEET_SKINS, SHEET_TYPES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, SLOT_TOKEN_RE, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SOCIAL_POST_NODE_TYPES, STAGE_PATCH_SCHEMA, STATIC_CAPTION_STYLES, STRUCTURAL_SECTIONS, STRUCTURED_VISION_MODELS, SUBMISSION_STATUSES, SUNO_ADD_TRACK_MODELS, SUNO_FIELD_HANDLE_FIELDS, SUNO_MODELS, SUNO_TEXT_MAX, SUNO_TITLE_MAX, SUNO_TRACK_SOURCE_TYPES, SUPPORTED_FONT_NAMES, SURROUND_DIRECTIONS, SWITCHX_BLOCK_FRAMES, SWITCHX_FRAME_TIERS, type SceneData, type SceneHelperName, SceneHelperNameSchema, type SceneInputMode, SceneInputModeSchema, type SceneMetadata, SceneMetadataSchema, type SceneNodeData, SceneNodeDataSchema, SceneSpecSchema, type ScraperActorId, type ScriptCriticVerdict, ScriptCriticVerdictSchema, type ScriptProvider, type Season, type SectionKind, type SelectorConfig, type SelectorFields, type SelectorMode, type SelectorPredicateOp, type SelectorResult, type SemanticAspectRatio, type SeparatorPreset, type SharedListing, type SharedVoice, type SheetAspect, type SheetBackground, type SheetCostEstimate, type SheetEntry, type SheetFlavour, type SheetGenerationPlan, type SheetPreset, type SheetPresetId, type SheetSection, type SheetSkin, type SheetTextData, type SheetType, type ShotElement, type ShotImageElement, type ShotShapeElement, type ShotSpec, ShotSpecSchema, type ShotTextElement, type ShowrunnerPlan, ShowrunnerPlanSchema, type SidecarLoader, type SlotControlDescriptor, type SlotControlKind, type SlotVariation, type SocialMediaContentType, type SocialMediaPlatform, type SocialMediaSpec, type SortDirection, type SortListOptions, type SortType, type StageAwaitingSubGateEvent, StageAwaitingSubGateEventSchema, type StaticCaptionStyle, type StoryboardCohesionCriticVerdict, StoryboardCohesionCriticVerdictSchema, type StyleDirectives, StyleDirectivesSchema, type SubGateName, SubGateNameSchema, type SubmissionStatus, type SunoAddTrackModel, type SunoModel, type SupportedFontName, type SurroundDirection, type Swatch, T2I_TO_I2I_VARIANT, TASK_CHAINED_EDIT_PROVIDERS, TEXT_TO_AUDIO_PROVIDERS, TEXT_TO_VIDEO_PROVIDERS, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, TILT_CARRIED_FRACTION, TRANSCRIBE_PROVIDERS, TRANSIENT_RUNTIME_KEYS, TTS_PROVIDERS, TTS_TEXT_MAX, TWO_K_RESOLUTION_PROVIDERS, type TextToAudioProvider, type TextToVideoProvider, type TranscribeProvider, type TransitionType, TransitionTypeSchema, type TrimVideoEstimatorInput, type TtsProvider, UPSCALE_IMAGE_PROVIDERS, USAGE_MODES, type UpscaleImageProvider, type UsageMode, VARIABLES_HANDLE_ID, VARIABLE_PRICING_MODELS, VEHICLES, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, VEO_PROVIDERS, VIDEO_ANALYSIS_BUCKET_CREDITS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_DURATION_BUCKETS, VIDEO_ANALYSIS_DURATION_TOLERANCE_SEC, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_LEGACY_MODELS, VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_MAX_DURATION_SEC, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_MIXED_TIERS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_LABELS, VIDEO_ANALYSIS_TIER_ORDER, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_ANALYSIS_WINDOW, VIDEO_AUDIO_CAPABILITY, VIDEO_AUDIT_BUCKET_CREDITS, VIDEO_CLIP_CREDITS, VIDEO_CRITIC_CREDITS_PER_SHOT, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_DURATION_TIERS, VIDEO_GEN_COLLAPSED_T2V_IDS, VIDEO_GEN_PROVIDERS, VIDEO_INPUT_LIP_SYNC_PROVIDERS, VIDEO_MODEL_CAPS, VIDEO_MODE_ALIASES, VIDEO_PRODUCER_TYPES, VIDEO_PROMPT_MAX, VIDEO_PROVIDERS_REQUIRING_IMAGE, VIDEO_PROVIDERS_WITHOUT_DISPATCH, VIDEO_REF_LIMITS_BY_PROVIDER, VIDEO_TO_VIDEO_PROVIDERS, VIDEO_UPSCALE_PROVIDERS, VIDEO_UTIL_PRICING, VIDEO_VARIABLE_PRICING, VOICE_CHANGER_MODELS, VOICE_CHANGER_MODEL_IDS, VOICE_DESIGN_MODELS, type ValidateMatchCutInput, ValidateMatchCutInputSchema, type ValidateMatchCutResult, ValidateMatchCutResultSchema, type ValidationField, type Vehicle, type VehicleSubcategory, type VideoAnalysisClipTransitionIn, type VideoAnalysisEntitySource, type VideoAnalysisMixedTier, type VideoAnalysisModelTier, type VideoAnalysisResult, type VideoAnalysisShotAngle, type VideoAnalysisSpeedEffect, type VideoAnalysisTextKind, type VideoAnalysisTier, type VideoAnalysisTransition, type VideoAnalysisVisualEffect, type VideoAudioCapability, type VideoAudioMode, type VideoClipCost, type VideoCriticFrameMode, type VideoCriticMetadataKey, type VideoCriticShotFields, type VideoCriticVerdict, VideoCriticVerdictSchema, type VideoGenProvider, type VideoModeAlias, type VideoModelCapabilities, type VideoToVideoProvider, type VideoUpscaleProvider, type Voice, type VoiceChangerModel, type VoiceClone, type VoiceDesignModel, type VoiceLibraryParams, type VoiceLibraryResponse, type VoiceMatch, VoiceMatchSchema, type VoiceType, WAN_3_DEFAULT_RESOLUTION, WAN_3_PROVIDERS, WARDROBE_VARIANTS, WEAPONS, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, WORKFLOW_VISIBILITIES, WORKSPACE_HEADER, WORKSPACE_HEADER_LOWER, WORKSPACE_ROLES, type Weapon, type WeaponSubcategory, type WindowAnalysis, type WindowScene, type WorkflowAssetKind, type WorkflowExport, type WorkflowExportCharacter, type WorkflowExportCreature, type WorkflowExportLocation, type WorkflowExportObject, type WorkflowImportReport, type WorkflowImportSkippedAsset, type WorkflowMediaRef, type WorkflowPortability, type WorkflowVisibility, type WorkspaceMemberView, type WorkspaceRole, type WorkspaceSettings, WorkspaceSettingsSchema, type WorkspaceSummary, type WorkspaceView, aggregateByType, aiAvatarReserveCreditId, analyzedSceneSchema, applyDefaultVideoSelection, applyHandleInputOverride, applyRange, applyRangeIndices, applySlots, applyVideoAudioToggle, applyVideoNegativePrompt, aspectRatioFromDims, aspectRatioOptionsByKind, aspectRatioToNumber, assembleNarratedVideoCredits, availableReasoningEfforts, bucketSecondsFromAuditCreditId, bucketSecondsFromCreditId, buildBoardPrompt, buildChildrenByParent, buildConditionVariables, buildCreditModelIdentifier, buildExpressionFromVisual, buildLipSyncCreditId, buildLlmCreditIdentifier, buildModelMenu, buildModelTree, buildMotionCreditModelIdentifier, buildNodePresetExport, buildPanelPrompt, buildProgressSegments, buildRangeLabel, buildScraperCreditId, buildVideoAnalysisCreditId, buildVideoAuditCreditId, buildVideoCreditModelIdentifier, calculateCombinedProgress, calculateMonetizationMarkup, calculateMonetizedCost, calculateProgress, canonicalVarName, characterBoardItems, characterBucketDisplayRank, characterMentionSlug, characterMentionableAssetArrays, characterSheetRefItems, characterVariantAssetArrays, cinematicCreditId, clampCinematicDuration, clampSmartCutWindow, cleanOrphanedItems, clearImageCriticMetadata, clearVideoCriticMetadata, clipLookSchema, collectAncestorRefs, combineSameLabelRefs, computeAggregateLanes, countRefModalityEdges, creditRangesAll, creditsToUsd, decodeProviderItem, defaultCarriedFraction, defaultResolutionFor, defaultRoleForSource, defaultVideoAspectRatio, deriveLinkedFields, deriveLottieSlotFields, deriveSlotRefs, describeEdgeBehavior, describeMaskRegion, describeNodeAdjustments, describeSlotControl, dropUnknownBindings, dropUnknownSpeakers, durationsByMode, effectiveReasoningEffort, encodeProviderItem, ensureLocaleCatalogLoaded, entityHydrationColumns, entityMentionSlug, entityMentionSlugForRef, entityScalarFields, entitySlotSchema, entryMatchesQuery, estimateCombineVideosCredits, estimateFilmCredits, estimateLoopTrimAddonCredits, estimateLoopVideoCredits, estimateScriptDurationSec, estimateSheetCost, estimateTrimVideoCredits, evaluateCondition, evaluateConditionGroup, evaluateJsonExpression, evaluateJsonPath, expandExtraRefsToConnectedReferences, expandItemsWithRepeat, extractAllGeneratedResults, extractCharacterLoraFields, extractGeneratedJsonAsList, extractPresetData, extractReferencedLabels, extractVideoDurationFromNode, fieldKeyFromHandle, filterCloneNodes, findCharacterMentionTokens, findEntityMentionTokens, findImageMentionTokens, findLocationMentionTokens, findSeedance2AudioOverLimit, firstSightExtraRole, flattenItems, getAnimal, getAnimalLabel, getAnimalPromptHint, getAnimalTerm, getAspectRatioOptions, getAudioCrossfadeCurve, getCharacterFacet, getCombineTransition, getCreditRange, getDurationsForModel, getEffectiveRepeatCount, getFeaturedEntities, getFurniture, getFurnitureLabel, getInputFieldSchema, getInputNodes, getItemSortId, getLipSyncMaxAudioSeconds, getLlmModalityCaps, getLlmModel, getLlmTier, getLocaleDirection, getMaxImagePromptChars, getMaxNegativePromptChars, getMaxSunoPromptChars, getMaxSunoStyleChars, getMaxTtsChars, getMaxVideoPromptChars, getModel, getNodeLabel, getNodeResult, getOutputNodes, getOutputType, getParameterValue, getQualityOptions, getResolutionOptions, getRouteReachableNodeIds, getStrategy, getTargetField, getValidValues, getVehicle, getVehicleLabel, getVideoAudioCapability, getWeapon, getWeaponLabel, groupByFamily, groupHandleId, groupLlmModelsByVendor, hasContiguousSegmentDurations, hasFeature, hexToRgbaArray, humanizeSlotSid, imageMentionSlug, imageMentionSlugForRef, imageReferenceLimit, inferMusicVideo, isAggregateableType, isCharacterAspectRatio, isCollectInEdge, isDefaultSelectorConfig, isExpandedClone, isFlux2Model, isGeminiOmniProvider, isGvpSupportedProvider, isHandleInputWired, isKineticCaptionStyle, isLocationUsageMode, isMinimaxH3Provider, isObjectAspectRatio, isOversizedScene, isPaygRetentionActive, isPerSecondLipSyncProvider, isScraperActor, isSeedance2Provider, isTiltDirection, isUsageMode, isVeoProvider, isVideoAnalysisMixedTier, isVideoAnalysisTier, isWan3Provider, jsonResultToList, knownEntitySlugsFromRefs, knownImageSlugsFromRefs, listBoardTemplates, listModels, listSlotSids, llmRouteDefaults, locationMentionSlug, locationReferencePhotoKindLabel, locationUsageModeLabel, mapAspectRatio, mapQuality, mapShotIntentToProviderDirectives, matchVariant, maxSegmentSecFor, maxSegmentsFor, mergeClipLook, mergeExposedSettings, migrateEdgeOutputMode, migrateToItems, minSegmentSecFor, modelIdsByKindMode, modelToNodeTarget, modelsForInputMode, modelsWithFeature, motionGraphicsFeature, normalizeLottieLayers, normalizeMinimaxH3Resolution, normalizeModelInput, normalizeNodeModelParams, normalizePinterestUrl, normalizeRoleSlug, normalizeWan3Resolution, orderedLlmModels, parseAttributedDialogue, parseCharacterMentionToken, parseEntityMentionToken, parseGroupHandle, parseHandleId, parseImageMentionToken, parseListExpression, parseLocationMentionToken, parseNodePresetExport, parseNodeRef, pickAiAvatarBucket, pickIds, pickLipSyncBucket, pickSwitchXFrameTier, pickVideoAnalysisBucket, planSheetGeneration, planSheetPanels, preferredInputModeForModel, presentTypes, presetApplyClearKeys, presetDataMatches, presetEntries, qualityOptionsByKind, readPromptAffixes, refHandleCategory, referenceModalityForHandle, referenceSheetCreditId, registerCatalogSidecars, registerSidecarLoaders, renderAnalyzedScene, resetCatalogSidecars, resolutionOptionsByKind, resolveAiAvatarCreditId, resolveAudioCrossfadeCurve, resolveCharacterAspectRatio, resolveCinematicCreditId, resolveConditionValue, resolveDefaultRole, resolveDescription, resolveDialogueVoices, resolveEffectiveSourceType, resolveEffectiveTier, resolveEntityAspect, resolveFieldMappings, resolveGvpAnchorWire, resolveImageGenCreditIdentifier, resolveIndex, resolveLabel, resolveListExpression, resolveLlmCreditId, resolveLocationFields, resolveLocationPresetCatalog, resolveLottieOverlaySrc, resolveNodeRefs, resolveObjectAspectRatio, resolvePipelineModel, resolveRelativeWindowToken, resolveScraperCreditId, resolveSelectorRefs, resolveSeparator, resolveSheetSections, resolveSlideshowTransition, resolveSourceThroughConnectedList, resolveStoredTier, resolveSwitchXCreditId, resolveVideoAnalysisModel, resolveVideoModeForInputs, resolveVideoProviderForMode, resolveXfadeName, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, rgbaArrayToHex, roleToPhrase, runSelector, sanitizeRole, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripExportContent, stripTransientRuntimeData, supportedDefaultDimensions, supportsAdvancedMode, supportsEndAnchor, supportsExtendRender, toConnectedReference, toConnectedReferences, togglePick, tryParseJson, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unwrapUnresolvedTokens, usageModeDirective, usageModeIncludesName, usageModeLabel, usdToCredits, validateAiAvatarPayload, validateCinematicAvatarPayload, validateDurationForFormat, validateModeActivation, validateModelInput, validateNoNestedGroups, validateObjects, validateProviderForNodeType, validateSubWorkflowRoutes, variantJobId, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };
+export { ACCESS_LEVELS, ACTIVE_SCENE_HELPERS, ADVANCED_MODE_UNAVAILABLE_REASON, AGGREGATEABLE_TYPES, AGGREGATE_LANE_SOURCE_TYPES, AI_AVATAR_DURATION_BUCKETS, AI_AVATAR_MAX_AUDIO_SEC, AI_AVATAR_MAX_DURATION_SEC, AI_AVATAR_RESERVE_IDS, AI_WRITER_PROVIDERS, ALA_CARTE_BOARDS, ALL_CAPTION_STYLES, ANIMALS, ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, ASPECT_RATIO_DIMENSIONS, AUDIO_ADDON_PROVIDERS, AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, AUDIO_PRODUCER_TYPES, type AccessLevel, type AddBRollResult, AddBRollResultSchema, type AggregateableType, type AggregationBuckets, type AiAvatarDurationBucket, type AiAvatarEngine, type AiAvatarResolution, type AiWriterProvider, type AlaCarteBoard, type AnalyzedScene, type AnchorSceneStyleResult, AnchorSceneStyleResultSchema, type Animal, type AnimalSubcategory, type AssetRef, AssetRefSchema, type AudioCrossfadeCurve, type AudioFxPreset, type AudioLayer, type AuditImagesResult, AuditImagesResultSchema, type AuditImagesShotEntry, AuditImagesShotEntrySchema, AuditPromptIssueSchema, type AuditPromptResult, AuditPromptResultSchema, AvatarPayloadError, BOARD_TO_ASSET_TYPE, BOARD_TO_COLUMN, BOARD_VARIANTS, type BoardEntityKind, type BoardPromptContext, type BoardTemplate, BridgeToNextSceneInputSchema, type BridgeToNextSceneResult, BridgeToNextSceneResultSchema, type BrowseCommunityParams, type BrowseCommunityResult, CATEGORY_DURATION_DEFAULTS, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASSET_TYPES, CHARACTER_ASSET_VARIANTS, CHARACTER_ATTACH_COLUMNS, CHARACTER_FACETS, CHARACTER_FACET_IDS, CHARACTER_LORA_TRAINING_JOB_TYPE, CHARACTER_MOTION_PROVIDERS, CHARACTER_PICKER_DISPLAY_ORDER, CHARACTER_REFERENCE_PHOTO_KINDS, CHARACTER_STYLES, CHARACTER_VARIANT_ASSET_BUCKETS, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, CINEMATIC_DEFAULT_DURATION_SEC, CINEMATIC_DEFAULT_RESOLUTION, CINEMATIC_MAX_DURATION_SEC, CINEMATIC_MAX_LOOKS, CINEMATIC_MAX_REFERENCE_IMAGES, CINEMATIC_MAX_REFERENCE_VIDEOS, CINEMATIC_MIN_DURATION_SEC, CINEMATIC_MIN_LOOKS, CINEMATIC_PROMPT_MAX, CINEMATIC_RESERVE_IDS, COLLABORATOR_ROLES, COLLECT_IN_HANDLE, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, COMPOSER_PLAN_FIELDS, COMPOSER_PLAN_MAP, CONTENT_TYPES_BY_PLATFORM, CREATURE_ATTACH_COLUMNS, CREDIT_BASE_USD, CREDIT_ROUNDING_RESOLUTION, type CaptionStyle, type CastCoverageCriticVerdict, CastCoverageCriticVerdictSchema, type CharacterAspectRatio, type CharacterAssetType, type CharacterAssetTypeForAspect, type CharacterAttachColumn, type CharacterDef, type CharacterFacet, type CharacterImageCriticVerdict, CharacterImageCriticVerdictSchema, type CharacterLoraFields, type CharacterMentionTokenInfo, CharacterMetadataSchema, type CharacterMotionProvider, type CharacterReferencePhoto, type CharacterReferencePhotoKind, type CharacterVariantAssetBucket, type CharacterVariantAssetItem, type CharacterVoiceSpec, type ChatEnabledStage, type ChatTurnResponse, ChatTurnResponseSchema, type CinematicResolution, type ClipLook, type CloneListingResult, type CollaboratorRole, type CombineTransition, type CombineTransitionGroup, type CombineVideosEstimatorInput, type CommunityCard, type CommunityEntityType, type CommunityFullDetail, type CommunityReportReason, type CommunitySort, type ComponentHandle, type ComponentMetadata, type ConnectedReference, type CreatureAttachColumn, CriticIssueSchema, type CustomEntry, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, DEFAULT_CARRIED_FRACTION, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, DEFAULT_CHARACTER_FACET, DEFAULT_LABEL_BY_SOURCE, DEFAULT_LOCATION_USAGE_MODE, DEFAULT_PANEL_COUNT, DEFAULT_REF_IMAGE_MAX, DEFAULT_SECTIONS, DEFAULT_USAGE_MODE, DEFAULT_VIDEO_ANALYSIS_MODEL, DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_CLIP_COST, DEFAULT_VIDEO_DURATION_SEC, DEFAULT_VIDEO_PROVIDER, DEFAULT_VOICE_CHANGER_MODEL, DEFAULT_VOICE_DESIGN_MODEL, DETAIL_VARIANTS, DURATION_PRICED_PROVIDERS, DYNAMIC_PRODUCER_TYPES, type DetectionResult, DetectionResultSchema, type DialogueLine, EFFORT_TIER_BUMP, EMOTIONAL_BEAT, ENTITY_ASPECT_DEFAULTS, ENTITY_BUCKET_FIELDS, ENTITY_DB_ID_FIELD, ENTITY_IMAGE_HANDLE_TYPES, ENTITY_KIND_SCALAR_FIELDS, ENTITY_NAME_FIELD, ENTITY_NODE_KINDS, ENTITY_SCALAR_FIELDS, ENTITY_SECTIONS, ENTITY_STATUSES, ENTITY_TABLE, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, EXECUTION_DATA_KEYS, EXTEND_VIDEO_PROVIDERS, type EntityKind, type EntityMentionTokenInfo, type EntityMetadata, EntityMetadataSchema, type EntityNodeKind, type EntityReferenceInput, type EntityRejectInput, EntityRejectInputSchema, type EntitySlot, type EntityStaleEvent, EntityStaleEventSchema, type EntityStateChangeEvent, EntityStateChangeEventSchema, type EntityStatus, type EntityStudioKind, type EntityStyle, type EntityType, type EvaluateConditionOptions, type ExportedPreset, type ExposableField, type ExposableOutput, type ExposedSetting, type ExtendVideoProvider, type ExtraRefCharacterContext, type ExtraRefInput, FACE_SWAP_PROVIDERS, FAL_LIP_SYNC_PROVIDERS, FAN_OUT_EACH_TYPES, FEATURED_ENTITIES, FILM_BASE_CREDITS, FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS, FLUX2_RES_MP, FLUX_LORA_CHARACTER_MODEL_ID, FRAME_MODE_ADAPTIVE_ONLY_ASPECT, FRAME_TARGET_HANDLES, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, FURNITURE, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, type FaceSwapProvider, type FavoriteListingResult, type FeaturedEntity, type FilmCreditEstimate, type FilterListCondition, type FilterListOperator, type FilterOperator, type FixContinuityInput, FixContinuityInputSchema, type FixContinuityResult, FixContinuityResultSchema, type Flux2Model, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, type FullSelectorMode, type Furniture, type FurnitureSubcategory, GEMINI_OMNI_PROVIDERS, GENERATE_TEXT_DELIMITER, GLOBAL_MAX_DURATION_SECONDS, GRANTED_ACCESS, GROUP_HANDLE_PREFIX, GUIDANCE_SCALE_SUPPORT, GVP_ANCHOR_CHOICES, GVP_DEFAULT_PROVIDER, GVP_END_FRAME_PROVIDERS, GVP_EXTEND_PROVIDERS, GVP_SUPPORTED_PROVIDERS, GenerateMotionInputSchema, type GenerateMotionResult, GenerateMotionResultSchema, type GenericEdge, type GenericNode, type GrantedAccess, type GvpAnchorChoice, type GvpAnchorWireMode, HANDLE_PORT_SEPARATOR, HELPERS_SHIPPED_IN_1B3, HIGH_QUALITY_PROVIDERS, HINT_EXEMPT_PARAMETER_TYPES, type HintEdgeLike, type HintGraphContext, type HintNodeLike, type I18nCatalogId, I2I_MASK_SUPPORT, I2I_STRENGTH_SUPPORT, IDEOGRAM_PROVIDERS, IMAGE_ASPECT_RATIO_VALUES, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, IMAGE_EDIT_PROVIDERS, IMAGE_GEN_PROVIDERS, IMAGE_I2I_PROVIDERS, IMAGE_MASK_MODE, IMAGE_PROMPT_MAX, IMAGE_REF_TYPES, IMAGE_TO_VIDEO_PROVIDERS, INPUT_FIELD_MAP, INPUT_NODE_TYPES, INSTAGRAM_CAROUSEL_MAX_ITEMS, INSTAGRAM_CAROUSEL_MIN_ITEMS, ITER_CLONE_PATTERN, type IdentityFidelity, type IdentityMeta, type ImageAspectRatio, type ImageCriticIssue, ImageCriticIssueSchema, type ImageCriticLeafMode, type ImageCriticMetadataKey, type ImageCriticMode, type ImageCriticNodeIssue, type ImageCriticResult, ImageCriticResultSchema, type ImageCriticVerdict, ImageCriticVerdictSchema, type ImageEditProvider, type ImageGenProvider, type ImageI2IProvider, type ImageMaskMode, type ImageMentionTokenInfo, type ImageToVideoProvider, type ImprovePromptInput, ImprovePromptInputSchema, type ImprovePromptResult, ImprovePromptResultSchema, type InputFieldSchema, type InvitationDelivery, type InvitationPreview, type InvitationState, type InvitationView, type JoinCodeView, type JsonEvalResult, type JsonFilter, type JsonPatch, KEYFRAME_CREDITS_PER_SHOT, KINETIC_CAPTION_STYLES, type KieApiFormat, type KineticCaptionStyle, LANGUAGES, LEGACY_LOTTIE_HOST_REMAP, LIP_SYNC_DURATION_BUCKETS, LIP_SYNC_MAX_AUDIO_SECONDS, LIP_SYNC_PROVIDERS, LLM_FEATURE_DEFAULTS, LLM_MODALITY_CAPS, LLM_MODELS, LLM_MODEL_IDS, LLM_REASONING_EFFORTS, LLM_ROUTE_DEFAULTS, LLM_TEXT_INPUT_MAX, LLM_VENDOR_LABELS, LLM_VENDOR_ORDER, LOCATION_ASSET_TYPES, LOCATION_ASSET_VARIANTS, LOCATION_ATMOSPHERE_PROVIDERS, LOCATION_ATTACH_COLUMNS, LOCATION_BUCKET_TO_CATALOG_ID, LOCATION_PRESET_TO_CATALOG, LOCATION_REFERENCE_PHOTO_KINDS, LOCATION_REFERENCE_PHOTO_KIND_LABELS, LOCATION_USAGE_MODES, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LabeledOption, type LipSyncDurationBucket, type LipSyncProvider, type LlmFeature, type LlmModelDef, type LlmModelGroup, type LlmReasoningEffort, type LlmRouteDefaults, type LlmTier, type LlmVendor, type LocaleCatalogMap, type LocaleDirection, type LocaleId, type LocationAssetType, type LocationAtmosphereProvider, type LocationAttachColumn, type LocationCatalogRef, type LocationImageCriticVerdict, LocationImageCriticVerdictSchema, type LocationMentionTokenInfo, LocationMetadataSchema, type LocationReferencePhotoKind, type LocationUsageMode, LocationsCoverageCriticIssueSchema, type LocationsCoverageCriticVerdict, LocationsCoverageCriticVerdictSchema, type LoopTrimEstimatorInput, type LoopVideoEstimatorInput, type LoraEligibleRef, type LoraRouting, type LottieOverlayCatalogEntry, type LottieSlotField, MAX_CUSTOM_ENTRIES_PER_BOARD, MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER, MAX_LOCATION_VARIANTS, MAX_NEGATIVE_PROMPT_CHARS_BY_PROVIDER, MAX_PANELS_PER_SHEET, MAX_TTS_CHARS_BY_PROVIDER, MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER, MEMBER_STATUSES, MINIMAX_H3_DEFAULT_RESOLUTION, MINIMAX_H3_PROVIDERS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, MODEL_CATALOG, MODEL_PARAM_NODE_TYPES, MODEL_RECOMMENDATIONS, MODIFY_IMAGE_PROVIDERS, MOTION_COLUMN, MOTION_TRANSFER_PROVIDERS, MUSIC_PROVIDERS, type MaskRegionDescriptor, type MatchCutVerdict, MatchCutVerdictSchema, type MeOrganizations, type Member, type MemberStatus, type MinimalEdge, type MinimalNode, type ModelCatalogEntry, type ModelInputAdjustment, type ModelKind, type ModelMenuOption, type ModelMode, type ModelNodeTarget, type ModelPromptingStyle, type ModelRecommendation, type ModelTreeLine, type ModelTreeVariant, type ModelValidationIssue, type ModifyImageProvider, type MotionTransferProviderType, type MusicProvider, NATIVE_ADAPTIVE_ASPECT, NATIVE_NEGATIVE_PROMPT_MODELS, NATIVE_NEGATIVE_VIDEO_PROVIDERS, NEGATIVE_PROMPT_MAX, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, NODE_DEFAULT_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_REF_PATTERN, NON_EN_LOCALE_IDS, NO_SPLIT_DELIMITER, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, type NodeDefaultType, type NodeParamAdjustment, type NodePresetExport, type NormalizedImageGen, type NormalizedModelInput, type NormalizedNodes, type NormalizedVideoRequest, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ASSET_VARIANTS, OBJECT_ATTACH_COLUMNS, OBJECT_MOTION_PROVIDERS, OBJECT_PICKER_NODE_TYPES, ORG_ERROR_CODES, ORG_KINDS, ORG_ROLES, ORG_STATUSES, OUTPUT_FIELD_MAP, OUTPUT_FORMATS, type ObjectAspectRatio, type ObjectAssetType, type ObjectAssetTypeForAspect, type ObjectAttachColumn, ObjectMetadataSchema, type ObjectMotionProvider, type ObjectsValidationIssue, type ObjectsValidationResult, OptimizeForModelInputSchema, type OptimizeForModelResult, OptimizeForModelResultSchema, type OrgAuditEntry, type OrgErrorCode, type OrgKind, type OrgMemberView, type OrgPage, type OrgRole, type OrgSettings, OrgSettingsSchema, type OrgStatus, type OrganizationSummary, type OrganizationView, type OutputFormat, type OutputMode, type OutputType, PARAMETER_NODE_TYPES, PASSTHROUGH_TYPES, PAYG_RETENTION_DAYS, PER_FORMAT_DURATION_BOUNDS, PICKER_TO_COMBINE_TRANSITION, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, PLACEHOLDER_CHARACTER_NAME, PLATFORM_LABELS, PLATFORM_SPECS, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LABELS, PRESET_SETTING_KEYS, PRICING_DEFAULT_DURATION_SEC, PRICING_DEFAULT_RESOLUTION, PROMPT_HARD_CEILING, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PROVIDER_DIRECTIVE_DEFAULTS, PROVIDER_PLACEHOLDER_PREFIX, type PanelGenRequest, type PanelRequest, type PanelSource, type PipelineActivationMode, type PipelineCompletedEvent, PipelineCompletedEventSchema, type PipelineConfig, PipelineConfigSchema, type PipelineDriftSummary, PipelineDriftSummarySchema, type PipelineEditorDecisionsReadyEvent, PipelineEditorDecisionsReadyEventSchema, type PipelineEvent, type PipelineForkedEvent, PipelineForkedEventSchema, type PipelineFormat, type PipelineInput, PipelineInputSchema, type PipelineLifecycleEvent, type PipelineMode, type PipelineModelStage, type PipelineMusicReadyEvent, PipelineMusicReadyEventSchema, type PipelineOutputResolution, type PipelinePinnableImageModel, type PipelinePinnableScriptLlm, type PipelinePinnableVideoModel, type PipelineStageName, PipelineStageNameSchema, type PipelineStageStatus, PipelineStageStatusSchema, type PipelineState, PipelineStateSchema, type PipelineStatus, PipelineStatusSchema, type PipelineType, type PixelBox, type PresentationItem, type PresetEntry, type PresetSettingKey, type PresetSettings, PresetSettingsSchema, type PriceVariant, type PricedVideoSelection, type ProgressSegment, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type PromptAffixFields, type PromptAffixes, type ProposedChange, type PublishListingParams, type PublishListingResult, QA_CHECK_PROVIDERS, type QaCheckProvider, type QualityLevel, REDUCE_STRATEGIES, REDUCE_STRATEGY_IDS, REFERENCE_BOARD_PROVIDERS, REFERENCE_BOARD_TEMPLATES, REFERENCE_HANDLE_MAP, REFERENCE_ROLE_PRESETS, REF_HANDLE_CATEGORY, REF_IMAGE_MAX_LIMITS, REF_TOKEN_NAMESPACE_PREFIXES, RENDERING_SPEED_SUPPORT, REPEATABLE_NODE_TYPES, REPEAT_PLACEHOLDER, REPLICATE_LIP_SYNC_PROVIDERS, RESERVED_TEMPLATE_VARS, type ReduceMeta, type ReduceStrategy, type ReduceStrategyId, type RefCandidate, type RefModalityEdge, type RefTokenKind, type RefVideoDurationLimit, type ReferenceBoardProvider, type ReferenceModality, type ReferenceSheet, type ReferenceSource, type ReportListingResult, type ResolveCharacterAspectOptions, type ResolveObjectAspectOptions, type ResolveSeparatorOptions, type ResolvedDialogueVoiceLine, type RouterConditionGroup, SCENE_HELPER_NAMES, SCRAPER_ACTOR_LABELS, SCRAPER_CREDIT_COSTS, SCRAPER_OUTPUT_FIELDS, SCRIPT_PROVIDERS, SEASONS, SECTION_BOARD, SECTION_KINDS, SEEDANCE_2_5_REF_LIMITS, SEEDANCE_2_CONTINUATION_REF_SEC, SEEDANCE_2_EXTEND_STITCH, SEEDANCE_2_PROVIDERS, SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER, SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC, SEEDANCE_2_REF_LIMITS, SEEDANCE_LIP_SYNC_PROVIDERS, SEED_SUPPORT, SEPARATOR_DISPLAY, SEPARATOR_PRESETS, SHEET_ASPECTS, SHEET_BACKGROUNDS, SHEET_PRESETS, SHEET_SKINS, SHEET_TYPES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, SLOT_TOKEN_RE, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SOCIAL_POST_NODE_TYPES, STAGE_PATCH_SCHEMA, STATIC_CAPTION_STYLES, STRUCTURAL_SECTIONS, STRUCTURED_VISION_MODELS, SUBMISSION_STATUSES, SUNO_ADD_TRACK_MODELS, SUNO_FIELD_HANDLE_FIELDS, SUNO_HARD_CEILING, SUNO_MODELS, SUNO_SELECT_OPERATIONS, SUNO_TEXT_MAX, SUNO_TITLE_MAX, SUNO_TRACK_SOURCE_TYPES, SUNO_VERSION_PRICED_OPERATIONS, SUPPORTED_FONT_NAMES, SURROUND_DIRECTIONS, SWITCHX_BLOCK_FRAMES, SWITCHX_FRAME_TIERS, type SafetyRetryPolicy, type SceneData, type SceneHelperName, SceneHelperNameSchema, type SceneInputMode, SceneInputModeSchema, type SceneMetadata, SceneMetadataSchema, type SceneNodeData, SceneNodeDataSchema, SceneSpecSchema, type ScraperActorId, type ScriptCriticVerdict, ScriptCriticVerdictSchema, type ScriptProvider, type Season, type SectionKind, type SelectorConfig, type SelectorFields, type SelectorMode, type SelectorPredicateOp, type SelectorResult, type SemanticAspectRatio, type SeparatorPreset, type SharedListing, type SharedVoice, type SheetAspect, type SheetBackground, type SheetCostEstimate, type SheetEntry, type SheetFlavour, type SheetGenerationPlan, type SheetPreset, type SheetPresetId, type SheetSection, type SheetSkin, type SheetTextData, type SheetType, type ShotElement, type ShotImageElement, type ShotShapeElement, type ShotSpec, ShotSpecSchema, type ShotTextElement, type ShowrunnerPlan, ShowrunnerPlanSchema, type SidecarLoader, type SlotControlDescriptor, type SlotControlKind, type SlotVariation, type SocialMediaContentType, type SocialMediaPlatform, type SocialMediaSpec, type SortDirection, type SortListOptions, type SortType, type StageAwaitingSubGateEvent, StageAwaitingSubGateEventSchema, type StaticCaptionStyle, type StoryboardCohesionCriticVerdict, StoryboardCohesionCriticVerdictSchema, type StyleDirectives, StyleDirectivesSchema, type SubGateName, SubGateNameSchema, type SubmissionStatus, type SunoAddTrackModel, type SunoModel, type SupportedFontName, type SurroundDirection, type Swatch, T2I_TO_I2I_VARIANT, TASK_CHAINED_EDIT_PROVIDERS, TEXT_TO_AUDIO_PROVIDERS, TEXT_TO_VIDEO_PROVIDERS, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, TILT_CARRIED_FRACTION, TOPAZ_DEFAULT_UPSCALE_FACTOR, TOPAZ_UPSCALE_FACTORS, TRANSCRIBE_PROVIDERS, TRANSIENT_RUNTIME_KEYS, TTS_PROVIDERS, TTS_TEXT_MAX, TWO_K_RESOLUTION_PROVIDERS, type TextToAudioProvider, type TextToVideoProvider, type TopazUpscaleAdjustment, type TopazUpscaleFactor, type TopazUpscaleResolution, type TranscribeProvider, type TransitionType, TransitionTypeSchema, type TrimVideoEstimatorInput, type TtsProvider, UPSCALE_IMAGE_PROVIDERS, USAGE_GROUP_BYS, USAGE_MODES, type UpscaleImageProvider, type UsageGroupBy, type UsageLogEntry, type UsageMode, type UsageQuery, type UsageReport, type UsageReportRow, type UsageReportTotals, type UsageVarianceRow, VARIABLES_HANDLE_ID, VARIABLE_PRICING_MODELS, VEHICLES, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, VEO_PROVIDERS, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_BUCKET_CREDITS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_DURATION_BUCKETS, VIDEO_ANALYSIS_DURATION_TOLERANCE_SEC, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_LEGACY_MODELS, VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_MAX_DURATION_SEC, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_MIXED_TIERS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_LABELS, VIDEO_ANALYSIS_TIER_ORDER, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_ANALYSIS_WINDOW, VIDEO_AUDIO_CAPABILITY, VIDEO_AUDIT_BUCKET_CREDITS, VIDEO_CLIP_CREDITS, VIDEO_CRITIC_CREDITS_PER_SHOT, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_DURATION_TIERS, VIDEO_GEN_COLLAPSED_T2V_IDS, VIDEO_GEN_PROVIDERS, VIDEO_INPUT_LIP_SYNC_PROVIDERS, VIDEO_MODEL_CAPS, VIDEO_MODE_ALIASES, VIDEO_PRODUCER_TYPES, VIDEO_PROMPT_MAX, VIDEO_PROVIDERS_REQUIRING_IMAGE, VIDEO_PROVIDERS_WITHOUT_DISPATCH, VIDEO_REF_LIMITS_BY_PROVIDER, VIDEO_REF_VIDEO_DURATION_LIMITS, VIDEO_TO_VIDEO_PROVIDERS, VIDEO_UPSCALE_PROVIDERS, VIDEO_UTIL_PRICING, VIDEO_VARIABLE_PRICING, VOICE_CHANGER_MODELS, VOICE_CHANGER_MODEL_IDS, VOICE_DESIGN_MODELS, type ValidateMatchCutInput, ValidateMatchCutInputSchema, type ValidateMatchCutResult, ValidateMatchCutResultSchema, type ValidationField, type Vehicle, type VehicleSubcategory, type VideoAnalysisAudioMode, type VideoAnalysisClipTransitionIn, type VideoAnalysisEntitySource, type VideoAnalysisMixedTier, type VideoAnalysisModelTier, type VideoAnalysisResult, type VideoAnalysisShotAngle, type VideoAnalysisSpeedEffect, type VideoAnalysisTextKind, type VideoAnalysisTier, type VideoAnalysisTransition, type VideoAnalysisVisualEffect, type VideoAudioCapability, type VideoAudioMode, type VideoClipCost, type VideoCriticFrameMode, type VideoCriticMetadataKey, type VideoCriticShotFields, type VideoCriticVerdict, VideoCriticVerdictSchema, type VideoGenProvider, type VideoModeAlias, type VideoModelCapabilities, type VideoToVideoProvider, type VideoUpscaleProvider, type Voice, type VoiceChangerModel, type VoiceClone, type VoiceDesignModel, type VoiceLibraryParams, type VoiceLibraryResponse, type VoiceMatch, VoiceMatchSchema, type VoiceType, WAN_3_DEFAULT_RESOLUTION, WAN_3_PROVIDERS, WARDROBE_VARIANTS, WEAPONS, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, WORKFLOW_VISIBILITIES, WORKSPACE_HEADER, WORKSPACE_HEADER_LOWER, WORKSPACE_ROLES, type Weapon, type WeaponSubcategory, type WindowAnalysis, type WindowScene, type WorkflowAssetKind, type WorkflowExport, type WorkflowExportCharacter, type WorkflowExportCreature, type WorkflowExportLocation, type WorkflowExportObject, type WorkflowImportReport, type WorkflowImportSkippedAsset, type WorkflowMediaRef, type WorkflowPortability, type WorkflowVisibility, type WorkspaceMemberView, type WorkspaceRole, type WorkspaceSettings, WorkspaceSettingsSchema, type WorkspaceSummary, type WorkspaceView, aggregateByType, aiAvatarReserveCreditId, analyzedSceneSchema, applyDefaultVideoSelection, applyHandleInputOverride, applyRange, applyRangeIndices, applySlots, applyVideoAudioToggle, applyVideoNegativePrompt, aspectRatioFromDims, aspectRatioOptionsByKind, aspectRatioToNumber, assembleNarratedVideoCredits, availableReasoningEfforts, bucketSecondsFromAuditCreditId, bucketSecondsFromCreditId, buildBoardPrompt, buildChildrenByParent, buildConditionVariables, buildCreditModelIdentifier, buildExpressionFromVisual, buildLipSyncCreditId, buildLlmCreditIdentifier, buildModelMenu, buildModelTree, buildMotionCreditModelIdentifier, buildNodePresetExport, buildPanelPrompt, buildProgressSegments, buildRangeLabel, buildScraperCreditId, buildVideoAnalysisCreditId, buildVideoAuditCreditId, buildVideoCreditModelIdentifier, calculateCombinedProgress, calculateMonetizationMarkup, calculateMonetizedCost, calculateProgress, canonicalVarName, characterBoardItems, characterBucketDisplayRank, characterMentionSlug, characterMentionableAssetArrays, characterSheetRefItems, characterVariantAssetArrays, checkRefVideoDurations, cinematicCreditId, clampCinematicDuration, clampSmartCutWindow, classifyRefToken, cleanOrphanedItems, clearImageCriticMetadata, clearVideoCriticMetadata, clipLookSchema, collectAncestorRefs, combineSameLabelRefs, computeAggregateLanes, countRefModalityEdges, creditRangesAll, creditsToUsd, decodeProviderItem, defaultCarriedFraction, defaultResolutionFor, defaultRoleForSource, defaultVideoAspectRatio, deriveLinkedFields, deriveLottieSlotFields, deriveSlotRefs, describeEdgeBehavior, describeMaskRegion, describeNodeAdjustments, describeSlotControl, dropUnknownBindings, dropUnknownSpeakers, durationsByMode, effectiveReasoningEffort, encodeProviderItem, ensureLocaleCatalogLoaded, entityHydrationColumns, entityMentionSlug, entityMentionSlugForRef, entityScalarFields, entitySlotSchema, entryMatchesQuery, estimateCombineVideosCredits, estimateFilmCredits, estimateLoopTrimAddonCredits, estimateLoopVideoCredits, estimateScriptDurationSec, estimateSheetCost, estimateTrimVideoCredits, evaluateCondition, evaluateConditionGroup, evaluateJsonExpression, evaluateJsonPath, expandExtraRefsToConnectedReferences, expandItemsWithRepeat, extractAllGeneratedResults, extractCharacterLoraFields, extractGeneratedJsonAsList, extractPresetData, extractReferencedLabels, extractVideoDurationFromNode, fieldKeyFromHandle, filterCloneNodes, findCharacterMentionTokens, findEntityMentionTokens, findImageMentionTokens, findLocationMentionTokens, findSeedance2AudioOverLimit, firstSightExtraRole, flattenItems, getAnimal, getAnimalLabel, getAnimalPromptHint, getAnimalTerm, getAspectRatioOptions, getAudioCrossfadeCurve, getCharacterFacet, getCombineTransition, getCreditRange, getDurationsForModel, getEffectiveRepeatCount, getFeaturedEntities, getFurniture, getFurnitureLabel, getInputFieldSchema, getInputNodes, getItemSortId, getLipSyncMaxAudioSeconds, getLlmModalityCaps, getLlmModel, getLlmTier, getLocaleDirection, getMaxImagePromptChars, getMaxNegativePromptChars, getMaxSunoPromptChars, getMaxSunoStyleChars, getMaxTtsChars, getMaxVideoPromptChars, getModel, getNodeLabel, getNodeResult, getOutputNodes, getOutputType, getParameterValue, getQualityOptions, getResolutionOptions, getRouteReachableNodeIds, getStrategy, getTargetField, getValidValues, getVehicle, getVehicleLabel, getVideoAudioCapability, getWeapon, getWeaponLabel, groupByFamily, groupHandleId, groupLlmModelsByVendor, hasContiguousSegmentDurations, hasFeature, hexToRgbaArray, humanizeSlotSid, imageMentionSlug, imageMentionSlugForRef, imageReferenceLimit, inferMusicVideo, isAggregateableType, isCharacterAspectRatio, isCollectInEdge, isDefaultSelectorConfig, isExpandedClone, isFlux2Model, isGeminiOmniProvider, isGvpSupportedProvider, isHandleInputWired, isKineticCaptionStyle, isLocationUsageMode, isMinimaxH3Provider, isObjectAspectRatio, isOversizedScene, isPaygRetentionActive, isPerSecondLipSyncProvider, isScraperActor, isSeedance2Provider, isTiltDirection, isUsageMode, isVeoProvider, isVideoAnalysisMixedTier, isVideoAnalysisTier, isWan3Provider, jsonResultToList, knownEntitySlugsFromRefs, knownImageSlugsFromRefs, listBoardTemplates, listModels, listSlotSids, llmRouteDefaults, locationMentionSlug, locationReferencePhotoKindLabel, locationUsageModeLabel, mapAspectRatio, mapQuality, mapShotIntentToProviderDirectives, matchVariant, maxSegmentSecFor, maxSegmentsFor, mergeClipLook, mergeExposedSettings, migrateEdgeOutputMode, migrateToItems, minSegmentSecFor, modelIdsByKindMode, modelToNodeTarget, modelsForInputMode, modelsWithFeature, motionGraphicsFeature, normalizeLottieLayers, normalizeMinimaxH3Resolution, normalizeModelInput, normalizeNodeModelParams, normalizePinterestUrl, normalizeRoleSlug, normalizeVideoRequestParams, normalizeWan3Resolution, orderedLlmModels, parseAttributedDialogue, parseCharacterMentionToken, parseEntityMentionToken, parseGroupHandle, parseHandleId, parseImageMentionToken, parseListExpression, parseLocationMentionToken, parseNodePresetExport, parseNodeRef, pickAiAvatarBucket, pickIds, pickLipSyncBucket, pickSwitchXFrameTier, pickVideoAnalysisBucket, planSheetGeneration, planSheetPanels, preferredInputModeForModel, presentTypes, presetApplyClearKeys, presetDataMatches, presetEntries, pricedVideoSelection, qualityOptionsByKind, readPromptAffixes, refHandleCategory, referenceModalityForHandle, referenceSheetCreditId, registerCatalogSidecars, registerSidecarLoaders, renderAnalyzedScene, resetCatalogSidecars, resolutionOptionsByKind, resolveAiAvatarCreditId, resolveAudioCrossfadeCurve, resolveCharacterAspectRatio, resolveCinematicCreditId, resolveConditionValue, resolveDefaultRole, resolveDescription, resolveDialogueVoices, resolveEffectiveSourceType, resolveEffectiveTier, resolveEntityAspect, resolveFieldMappings, resolveGvpAnchorWire, resolveImageGenCreditIdentifier, resolveIndex, resolveLabel, resolveListExpression, resolveLlmCreditId, resolveLocationFields, resolveLocationPresetCatalog, resolveLottieOverlaySrc, resolveNodeRefs, resolveNormalizedImageGen, resolveObjectAspectRatio, resolvePipelineModel, resolveRelativeWindowToken, resolveScraperCreditId, resolveSelectorRefs, resolveSeparator, resolveSheetSections, resolveSlideshowTransition, resolveSourceThroughConnectedList, resolveStoredTier, resolveSwitchXCreditId, resolveTopazUpscale, resolveVideoAnalysisModel, resolveVideoModeForInputs, resolveVideoProviderForMode, resolveXfadeName, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, rgbaArrayToHex, roleToPhrase, runSelector, safetyRetryPolicy, sanitizeRole, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripDerivedAnalysisFields, stripExportContent, stripTransientRuntimeData, sunoCreditType, supportedDefaultDimensions, supportsAdvancedMode, supportsEndAnchor, supportsExtendRender, toConnectedReference, toConnectedReferences, togglePick, tryParseJson, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unresolvedRefTokens, unwrapUnresolvedTokens, usageModeDirective, usageModeIncludesName, usageModeLabel, usdToCredits, validateAiAvatarPayload, validateCinematicAvatarPayload, validateDurationForFormat, validateModeActivation, validateModelInput, validateNoNestedGroups, validateObjects, validateProviderForNodeType, validateSubWorkflowRoutes, variantJobId, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };