@nodaro/shared 3.9.0 → 3.11.0

package/src/i18n/types.ts

@@ -120,6 +120,7 @@ export const I18N_CATALOGS = [
   "camera-format",
   "camera-motions",
   "character-fx",
+  "character-motion",
   "color-look",
   "composition-effects",
   "era",

package/src/index.ts

@@ -167,6 +167,7 @@ export {
   DEFAULT_VIDEO_DURATION_SEC,
   applyDefaultVideoSelection,
   PRICING_DEFAULT_DURATION_SEC,
+  pricedOutputDurationSec,
   PRICING_DEFAULT_RESOLUTION,
 } from "./model-constants.js"
 
@@ -547,6 +548,8 @@ export type { LocationCatalogRef } from "./location-preset-catalog-map.js"
 export {
   PARAMETER_NODE_TYPES,
   HINT_EXEMPT_PARAMETER_TYPES,
+  VIDEO_ONLY_PARAMETER_NODE_TYPES,
+  EXECUTION_GRAPH_COMPOSED_PARAMETER_TYPES,
   getParameterValue,
   setRegisteredPersonPackFields,
 } from "./parameter-node-value.js"
@@ -731,6 +734,8 @@ export {
   MODEL_RECOMMENDATIONS,
   listModels,
   groupByFamily,
+  groupByKindAndFamily,
+  MODEL_KINDS,
   getModel,
   validateModelInput,
   // Frontend picker derivers
@@ -977,6 +982,16 @@ export type { VoiceChangerModel } from "./voice-changer-models.js"
 // --- Node presets ---
 export { EXECUTION_DATA_KEYS, TRANSIENT_RUNTIME_KEYS, stripTransientRuntimeData } from "./node-runtime-keys.js"
 
+// --- Execution node state (wire contract) ---
+export {
+  OUTPUT_BEARING_NODE_STATUSES,
+  nodeStateMayCarryOutput,
+} from "./node-execution-state.js"
+export type {
+  NodeExecutionStatus,
+  NodeExecutionStateWire,
+} from "./node-execution-state.js"
+
 export {
   MODEL_PARAM_NODE_TYPES,
   normalizeNodeModelParams,
@@ -1003,6 +1018,9 @@ export * from "./reference-sheet/index.js"
 // --- Reference Board (templates + provider constant) ---
 export * from "./reference-board-templates.js"
 
+// --- Marketplace template categories (the eight use cases) ---
+export * from "./template-categories.js"
+
 // --- Model tree (derive node targets + product-line grouping for the Models tab) ---
 export * from "./model-tree.js"
 
@@ -1071,6 +1089,9 @@ export * from "./scene3d-v2.js"
 export * from "./scene3d-v2-plan.js"
 export * from "./scene3d-v2-resources.js"
 export * from "./scene3d-camera-track.js"
+// --- What an authoring run says about its own answer: assumptions, summary,
+//     repair count. Additive and optional on every Scene3D authoring lane. ---
+export * from "./scene3d-delivery-notes.js"
 // --- 3D Render Pro: one durable operation, scene + video in one result ---
 export * from "./pro-3d-render.js"
 // --- Scene3D render pricing: which frame-size tier a render settles at.
@@ -1088,3 +1109,8 @@ export * from "./scene3d-v2-edit.js"
 export { STUDIO_DEPENDENT_FRAMES_CAPABILITY, SequenceExecutionRequiredError, requiresSequenceExecution, assertCanvasExecutionAllowed } from "./sequence-execution"
 export * from "./scene3d-authoring-engine.js"
 export * from "./scene3d-input-assets.js"
+
+// --- Start/end frame fit: measured output canvases + the pure fit math ---
+export * from "./video-output-canvas.js"
+export * from "./video-frame-fit.js"
+export type { CharacterMotionMetadata } from "./character-motion-metadata.js"

package/src/model-catalog.ts

@@ -52,7 +52,6 @@ export type ModelMode =
   | "music"
   | "sfx"
   | "stt"
-  | "voice-clone"
   | "voice-design"
   | "voice-changer"
   | "isolation"
@@ -755,23 +754,8 @@ const IMAGE_MODELS: Record<string, ModelCatalogEntry> = {
       { identifier: "ideogram-remix:QUALITY", credits: 60, note: "best quality" },
     ],
   },
-  "ideogram-reframe": {
-    id: "ideogram-reframe",
-    kind: "image",
-    modes: ["edit"] as const,
-    family: "Ideogram",
-    label: "Ideogram Reframe",
-    series: "Ideogram",
-    description: "Outpaint / reframe to a new aspect ratio while preserving subject.",
-    useCases: ["outpaint", "reframe"],
-    features: ["reference-image"],
-    aspectRatios: IDEOGRAM_RATIOS,
-    pricing: [
-      { identifier: "ideogram-reframe", credits: 18, note: "BALANCED default" },
-      { identifier: "ideogram-reframe:TURBO", credits: 18, note: "fastest" },
-      { identifier: "ideogram-reframe:QUALITY", credits: 18, note: "best quality" },
-    ],
-  },
+  // `ideogram-reframe` was retired 2026-09-15 — KIE's `ideogram/v3-reframe`
+  // fails every task upstream (#1331); see IDEOGRAM_PROVIDERS in model-constants.
 
   // ── Google Imagen ──
   "imagen4": {
@@ -1238,9 +1222,17 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     family: "Google",
     label: "VEO 3.1 Quality",
     series: "VEO",
-    description: "Google VEO 3.1 Quality — premium cinematic video. 4/6/8s clips, optional end frame, native audio. Flat per-generation pricing across durations.",
+    description: "Google VEO 3.1 Quality — premium cinematic video. 4/6/8s clips, optional end frame, native audio. No reference-to-video mode (Fast/Lite only). Flat per-generation pricing across durations.",
     useCases: ["cinematic", "premium", "narrative"],
-    features: ["end-frame", "audio", "reference-image"],
+    // NO "reference-image": KIE serves REFERENCE_2_VIDEO on the Fast and Lite
+    // SKUs only. Its own words, on a production job (2026-09-04, app-reports
+    // lane G): "Reference to video only supports the Veo Fast model and Veo
+    // Lite model." Until 2026-09-15 this entry claimed the feature, so the
+    // editor offered the reference handles, the adapter sent
+    // generationType: "REFERENCE_2_VIDEO", and the call came back 422 every
+    // time — after credits were reserved. `veo3.1` (KIE `veo3_fast`) and
+    // `veo3_lite` DO serve it and keep the flag.
+    features: ["end-frame", "audio"],
     durations: [4, 6, 8],
     aspectRatios: VIDEO_RATIOS_HV,
     // 720p (default) + 1080p inline. 4K generates the base at 1080p then chains
@@ -2204,7 +2196,7 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     id: "omnihuman-1-5",
     kind: "video",
     modes: ["lip-sync"] as const,
-    family: "ByteDance",
+    family: "Bytedance",
     label: "OmniHuman 1.5",
     series: "OmniHuman",
     description: "Premium prompt-directed talking avatar from a still image + audio. 720p / 1080p, up to 60s. People, pets, anime.",
@@ -2468,17 +2460,8 @@ const AUDIO_MODELS: Record<string, ModelCatalogEntry> = {
   },
 
   // ── ElevenLabs voice utilities ──
-  "voice-clone": {
-    id: "voice-clone",
-    kind: "audio",
-    modes: ["voice-clone"] as const,
-    family: "ElevenLabs",
-    label: "Voice Clone (Instant)",
-    series: "ElevenLabs",
-    description: "Clone a voice from a short reference clip. Instant clone via direct ElevenLabs API.",
-    useCases: ["voice-clone", "personalization"],
-    pricing: [{ identifier: "voice-clone", credits: 50 }],
-  },
+  // (voice cloning was retired platform-wide on 2026-09-15 — no catalog entry,
+  //  no price, no MCP tool; existing clones still resolve as TTS voice ids.)
   "elevenlabs-voice-design": {
     id: "elevenlabs-voice-design",
     kind: "audio",
@@ -2534,6 +2517,17 @@ const AUDIO_MODELS: Record<string, ModelCatalogEntry> = {
     useCases: ["dubbing", "multilingual"],
     pricing: [{ identifier: "elevenlabs-dubbing", credits: 40, note: "per minute of the dubbed span (min 1)" }],
   },
+  "elevenlabs-dubbing-v2": {
+    id: "elevenlabs-dubbing-v2",
+    kind: "audio",
+    modes: ["dubbing"] as const,
+    family: "ElevenLabs",
+    label: "ElevenLabs Dubbing v2",
+    series: "ElevenLabs",
+    description: "Translate + dub audio or a whole video into a new language — video in, dubbed video out. Async.",
+    useCases: ["dubbing", "multilingual"],
+    pricing: [{ identifier: "elevenlabs-dubbing-v2", credits: 1100, note: "per minute of the dubbed span (min 1)" }],
+  },
   "elevenlabs-forced-alignment": {
     id: "elevenlabs-forced-alignment",
     kind: "audio",
@@ -2678,6 +2672,29 @@ export function groupByFamily(
   return Array.from(groups.entries()).map(([family, models]) => ({ family, models }))
 }
 
+export const MODEL_KINDS = ["image", "video", "audio"] as const satisfies readonly ModelKind[]
+
+/**
+ * The Image / Video / Audio envelope every model-discovery surface renders
+ * (`GET /v1/models`, MCP `list_models`): each model is filed under ITS OWN
+ * kind, then by vendor family within that kind — so a vendor that ships more
+ * than one kind (Google: Imagen + VEO, ByteDance: Seedream + Seedance, …)
+ * appears once per kind it actually ships.
+ *
+ * This is the ONE grouping both surfaces call. Grouping by family first and
+ * letting the family's first model pick the section filed every VEO, Seedance,
+ * Wan and ByteDance video model under "image" whenever the call carried no
+ * `kind` filter (#1332) — an explicit `kind` pre-filtered the list and hid it.
+ * Empty sections are omitted; section order is fixed image → video → audio.
+ */
+export function groupByKindAndFamily(
+  entries: ModelCatalogEntry[],
+): Array<{ kind: ModelKind; families: Array<{ family: string; models: ModelCatalogEntry[] }> }> {
+  return MODEL_KINDS
+    .map((kind) => ({ kind, families: groupByFamily(entries.filter((m) => m.kind === kind)) }))
+    .filter((section) => section.families.length > 0)
+}
+
 export function getModel(id: string): ModelCatalogEntry | undefined {
   return MODEL_CATALOG[id]
 }

package/src/model-constants.ts

@@ -91,14 +91,20 @@ export const MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER: Record<string, number> = {
   "seedream-5-lite-i2i": 3000, // docs.kie.ai/market/seedream-5-lite-image-to-image (NB: t2i sibling is 1000)
   "qwen": 3000,                // docs.kie.ai/market/qwen/text-to-image
   "qwen-edit": 2000,           // docs.kie.ai/market/qwen/image-edit
+  // Z-Image is the SHORTEST of the family — "maxLength: 1000" in its schema
+  // (docs.kie.ai/market/z-image/z-image, re-fetched 2026-09-15). It was listed
+  // below as "verified == 5000", which is how three production runs on
+  // 2026-09-07 sent a workflow-assembled prompt straight into KIE's
+  // `{"code":500,"msg":"The text length cannot exceed the maximum limit"}`.
+  "z-image": 1000,             // docs.kie.ai/market/z-image/z-image
   // verified == 5000 default (no entry needed): imagen4(-fast/-ultra), nano-banana,
   //   nano-banana-edit, flux, flux-flex, gpt-image-2, ideogram-v3/-edit/-remix,
-  //   z-image, grok, qwen-i2i, seedream-5-pro, seedream-5-pro-i2i
+  //   grok, qwen-i2i, seedream-5-pro, seedream-5-pro-i2i
   //   (docs.kie.ai/market/seedream/5-pro-text-to-image + 5-pro-image-to-image).
   // grok-i2i: doc states 390000 (78× its t2i sibling) — treated as a KIE schema
   //   typo and left at the 5000 default per the sanity-cap decision.
   // UNVERIFIED (no limit stated in schema) → 5000 default: flux-kontext(-max)
-  //   gpt-image, gpt-image-i2i, flux-i2i, flux-pro-i2i, ideogram-reframe.
+  //   gpt-image, gpt-image-i2i, flux-i2i, flux-pro-i2i.
 }
 
 /** Max assembled image-prompt length (chars) for a provider: its verified
@@ -508,7 +514,6 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "flux-kontext-max",
   "ideogram-edit",
   "ideogram-remix",
-  "ideogram-reframe",
   "qwen-i2i",
   "qwen-edit",
   "seedream-edit",
@@ -588,7 +593,6 @@ export const REF_IMAGE_MAX_LIMITS: Record<string, number> = {
   "flux-kontext-max": 1,
   "ideogram-edit": 1,
   "ideogram-remix": 1,
-  "ideogram-reframe": 1,
   "qwen-i2i": 1,
   "qwen-edit": 1,
   "grok-i2i": 1,
@@ -662,7 +666,6 @@ export const VARIABLE_PRICING_MODELS: Record<string, "quality" | "resolution" |
   "topaz-image-upscale": "resolution",
   "ideogram-edit": "rendering-speed",
   "ideogram-remix": "rendering-speed",
-  "ideogram-reframe": "rendering-speed",
   "ideogram-v3": "rendering-speed",
   "wan-2.7": "resolution",
   "wan-2.7-pro": "resolution",
@@ -689,7 +692,12 @@ export const RESOLUTION_2K_4K_TIERED_PROVIDERS = new Set([
 ])
 
 // Ideogram family models with TURBO/QUALITY pricing variants
-export const IDEOGRAM_PROVIDERS = new Set(["ideogram-edit", "ideogram-remix", "ideogram-reframe", "ideogram-v3"])
+// `ideogram-reframe` (KIE `ideogram/v3-reframe`) was retired 2026-09-15: KIE no
+// longer documents the model and every task — the minimal documented payload
+// included — fails upstream with "[500] internal error" (#1331). Its price rows
+// are removed by migration 424; re-add everywhere per the Provider Enum Sync
+// table if KIE brings it back.
+export const IDEOGRAM_PROVIDERS = new Set(["ideogram-edit", "ideogram-remix", "ideogram-v3"])
 
 // =====================================================================
 // Provider arrays (single source of truth for route Zod validation)
@@ -744,7 +752,6 @@ export const IMAGE_I2I_PROVIDERS = [
   "grok-2-i2i",
   "ideogram-edit",
   "ideogram-remix",
-  "ideogram-reframe",
   "qwen-i2i",
   "qwen-edit",
   "seedream-edit",
@@ -1365,7 +1372,7 @@ export const I2I_STRENGTH_SUPPORT: Record<string, { min: number; max: number; st
 
 /** Models that accept a seed parameter for reproducible generation */
 export const SEED_SUPPORT = new Set([
-  "ideogram-remix", "ideogram-reframe", "ideogram-v3",
+  "ideogram-remix", "ideogram-v3",
   "qwen", "qwen-i2i", "qwen-edit",
   "flux", "flux-flex", "flux-i2i", "flux-pro-i2i", "flux-kontext", "flux-kontext-max",
   "flux-2-klein", "kontext-multi",
@@ -1373,7 +1380,7 @@ export const SEED_SUPPORT = new Set([
 
 /** Ideogram models that support rendering_speed selection (TURBO/BALANCED/QUALITY) */
 export const RENDERING_SPEED_SUPPORT = new Set([
-  "ideogram-remix", "ideogram-reframe", "ideogram-v3",
+  "ideogram-remix", "ideogram-v3",
 ])
 
 /** Models that accept guidance_scale for controlling prompt adherence */
@@ -1979,8 +1986,13 @@ export const VIDEO_REF_LIMITS_BY_PROVIDER: Record<
   "kling-3-omni": { images: 7 },     // catalog/docs: "end frame + up to 7 reference images"
   "grok-i2v": { images: 7 },         // backend kie/models.ts maxRefImages: 7
   "happyhorse-ref2v": { images: 9 }, // backend kie/models.ts maxRefImages: 9
-  // VEO 3.x — REFERENCE_2_VIDEO path caps refs at 3 (kie/video.ts slice(0, 3)).
-  "veo3": { images: 3 },
+  // VEO 3.x — REFERENCE_2_VIDEO path caps refs at 3 (kie/video.ts slices to
+  // this number). `veo3` (VEO 3.1 QUALITY) is deliberately ABSENT: KIE serves
+  // reference-to-video on the Fast and Lite SKUs only and rejects it on
+  // Quality with "Reference to video only supports the Veo Fast model and Veo
+  // Lite model." (production, 2026-09-04). Absent ⇒ 0 ⇒ the handle dims, the
+  // `connectedReferences` assembly strips image tokens, and kie/video.ts never
+  // flips a Quality call to REFERENCE_2_VIDEO.
   "veo3.1": { images: 3 },
   "veo3_lite": { images: 3 },
   // NOTE: wan-i2v / hailuo-2.3[-pro] / bytedance-pro[-fast] / grok-imagine-video-1.5
@@ -2513,6 +2525,33 @@ export const VIDEO_VARIABLE_PRICING: Record<string, "duration" | "duration+audio
  */
 export const PRICING_DEFAULT_DURATION_SEC: Record<string, number> = {
   "minimax-h3": 6,
+  // KIE renders 8s when `duration` is omitted (kie/models.ts extraParams), and
+  // Seedance 2.5 prices one tier per second across 4–30s, so the 5s fallback
+  // billed a 5s tier against an 8s render — and under-reserved every
+  // reference-video run's output seconds by three (#1397).
+  "seedance-2-5": 8,
+  // Same shape: KIE renders 8s by default and the ladder is priced per second,
+  // so the 5s fallback billed a 5s tier against an 8s render (caught by the
+  // render-default ↔ priced-tier invariant in
+  // backend/src/providers/__tests__/pricing-default-duration-sync.test.ts).
+  "grok-imagine-video-1.5": 8,
+}
+
+/**
+ * The output seconds a request is PRICED at: the requested duration when the
+ * caller gave one, else the provider's own default render length
+ * ({@link PRICING_DEFAULT_DURATION_SEC}), else the historical 5s fallback.
+ *
+ * The ONE source for `buildVideoCreditModelIdentifier`'s tier AND for every
+ * dynamic reservation that scales by output seconds (the Seedance 2 and
+ * MiniMax Hailuo 3 reference-video overrides on both the route and the DAG
+ * lane) — a literal `?? 5` in any of those places re-opens the gap this map
+ * closes.
+ */
+export function pricedOutputDurationSec(provider: string, requested: number | string | undefined): number {
+  const fallback = PRICING_DEFAULT_DURATION_SEC[provider] ?? 5
+  const parsed = typeof requested === "string" ? parseInt(requested, 10) : requested
+  return parsed === undefined || Number.isNaN(parsed) ? fallback : parsed
 }
 
 /**

package/src/node-execution-state.ts

@@ -0,0 +1,95 @@
+/**
+ * The wire contract for one node's entry in an execution's `nodeStates` map —
+ * the shape the orchestrator persists on `workflow_executions.node_states`,
+ * emits on the SSE execution stream, and every client reads back.
+ *
+ * Why this lives here rather than in the backend
+ * ----------------------------------------------
+ * The shape had THREE independent declarations — the orchestrator's rich
+ * `NodeExecutionState` (workflow-engine/types.ts), the SDK's loose one
+ * (`packages/client/src/resources/executions.ts`) and the editor's local copy
+ * (`workflow-editor/run-handlers.ts`) — and nothing tied them together. The
+ * field that made that expensive is `output`: it used to be an unstated
+ * convention that only a COMPLETED node carries one, so every consumer read it
+ * exclusively under `status === "completed"` and a failed node's retained
+ * result had nowhere to travel.
+ *
+ * This module states the rule once. The backend keeps its richer `NodeOutput`
+ * typing (its `NodeExecutionState` must stay ASSIGNABLE to the wire shape — a
+ * type-level test pins that); the SDK and the editor extend/import it.
+ */
+
+/**
+ * The status a node reports inside an execution.
+ *
+ * `cancelled` is deliberately absent: a cancelled child job is mapped onto
+ * `skipped` by the reconcile lane (see `lib/reconcile/node-states.ts`), and a
+ * HELD job keeps `status: "running"` with the `awaitingReview` sidecar rather
+ * than adding a member here.
+ */
+export type NodeExecutionStatus =
+  | "pending"
+  | "running"
+  | "completed"
+  | "failed"
+  | "skipped"
+
+/**
+ * The statuses whose node state MAY carry `output`.
+ *
+ * `completed` is the obvious one. `failed` is here because a run can refuse
+ * its result and still RETAIN what it produced — the 3D-scene authoring lanes
+ * publish a real, renderable revision and then fail the job on the visual
+ * reviewer's verdict (`SCENE_QUALITY_FAILED`), so the scene and the refusal are
+ * both true at once. That output was billed; dropping it because the status is
+ * not `"completed"` is what this set exists to stop.
+ *
+ * `pending` / `running` / `skipped` never carry one: nothing has settled, or
+ * the node was gated out.
+ */
+export const OUTPUT_BEARING_NODE_STATUSES: ReadonlySet<NodeExecutionStatus> =
+  new Set<NodeExecutionStatus>(["completed", "failed"])
+
+/** Whether a node in this status may carry `output`. */
+export function nodeStateMayCarryOutput(status: string | undefined): boolean {
+  return (
+    status !== undefined &&
+    OUTPUT_BEARING_NODE_STATUSES.has(status as NodeExecutionStatus)
+  )
+}
+
+/**
+ * One node's execution state, as it travels on the wire.
+ *
+ * Additive by construction — an older client ignores fields it does not know,
+ * which is why `output` on a failed node is safe to start sending.
+ *
+ * `TOutput` lets a declaration that knows its own richer output shape (the
+ * orchestrator's `NodeOutput`, the editor's) stay ASSIGNABLE to this contract
+ * instead of restating it; the default is what an external client sees.
+ */
+export interface NodeExecutionStateWire<TOutput = Record<string, unknown>> {
+  status: NodeExecutionStatus | (string & {})
+  nodeType?: string
+  jobId?: string | null
+  /** Every job id of a fan-out node (one per list / loop iteration). */
+  jobIds?: string[]
+  creditsUsed?: number
+  error?: string | null
+  /** Stable code for a refusal a client may branch on — never on the text. */
+  errorCode?: string
+  /**
+   * What the node produced.
+   *
+   * Present for a `completed` node, and for a `failed` node whose run RETAINED
+   * a structured result (see {@link OUTPUT_BEARING_NODE_STATUSES}). A consumer
+   * that reads it must therefore gate on the FIELD, not on the status, and
+   * must not treat its presence as success.
+   */
+  output?: TOutput
+  startedAt?: string | null
+  completedAt?: string | null
+  /** The node's job is parked in `pending_review`; `status` stays "running". */
+  awaitingReview?: boolean
+  progress?: number
+}

package/src/parameter-node-value.ts

@@ -45,6 +45,7 @@ export const PARAMETER_NODE_TYPES: ReadonlySet<string> = new Set([
   "post-process-effects",
   "action-fx",
   "character-fx",
+  "character-motion",
   "transition",
   "loop-subject",
   "scene-count",
@@ -77,6 +78,62 @@ export const HINT_EXEMPT_PARAMETER_TYPES: ReadonlySet<string> = new Set([
   "aspect-ratio",
 ])
 
+/**
+ * Parameter pickers whose fragment only makes sense in MOTION — a camera move,
+ * a transition, a timeline, a character effect or a character movement. Every
+ * still-image consumer (generate-image, edit-image, image-to-image,
+ * modify-image, location) excludes these on BOTH executors and in the add-node
+ * popup. One set instead of three hand-synced copies: `STILL_IMAGE_EXCLUDE_TYPES`
+ * (frontend cinematography-hints.ts and backend payload-builder.ts) and
+ * `MOTION_ONLY_PICKER_TYPES` (frontend node-compatibility.ts) alias it.
+ */
+export const VIDEO_ONLY_PARAMETER_NODE_TYPES: ReadonlySet<string> = new Set([
+  "camera-motion",
+  "temporal",
+  "transition",
+  "character-fx",
+  "character-motion",
+])
+
+/**
+ * Pickers whose fragment depends on OTHER nodes wired into them — camera
+ * motion's and transition's start / end states, character motion's target and
+ * partner names, character FX's target name — so both executors must pass the
+ * graph to `getParameterPromptHint` for them.
+ *
+ * TRANSITION AND CHARACTER-FX JOINED THIS SET (signed off). They compose from
+ * the graph everywhere a human LOOKS at them — the config panel's injection
+ * preview and the canvas card both run
+ * `getParameterPromptHint(node, { nodes, edges })` — and on the frontend
+ * `{Label}` path (`execution-graph.ts :: extractNodeOutput`), but the two
+ * cinematography collectors that read THIS set dispatched them without the
+ * graph, so a wired `startState` / `target` was promised in the preview and
+ * dropped at execution. Admitting them here closes that gap on BOTH executors
+ * at once.
+ *
+ * THE BOUND, and it is proved rather than asserted: a picker with NOTHING
+ * wired to its own `startState` / `endState` / `target` handles emits
+ * byte-identical text with and without the graph — the composers are simply
+ * called with empty clause arrays either way. So only workflows that actually
+ * wire those handles change at all, and they change to the text their own
+ * preview already shows. The prompts package's
+ * `graph-composed-unwired-identity.test.ts` walks every transition and
+ * character-fx catalog entry in both hint modes, under two unwired graph
+ * shapes, and asserts that equality — with a wired positive control so it
+ * cannot go vacuous.
+ *
+ * ADD A NEW GRAPH-COMPOSED PICKER HERE AND TO
+ * `LABEL_REF_GRAPH_COMPOSED_PARAMETER_TYPES` (backend
+ * `services/workflow-engine/label-ref-hint-context.ts`) when it ships, so its
+ * `{Label}` text and its directly-wired text agree from its first release.
+ */
+export const EXECUTION_GRAPH_COMPOSED_PARAMETER_TYPES: ReadonlySet<string> = new Set([
+  "camera-motion",
+  "character-motion",
+  "transition",
+  "character-fx",
+])
+
 /**
  * Extra person-dimension data-field names contributed by registered person
  * packs. Content-free (field-name strings only) — populated at runtime by
@@ -158,6 +215,8 @@ export function getParameterValue(
       return trim(data.actionFx)
     case "character-fx":
       return trim(data.characterFx)
+    case "character-motion":
+      return trim(data.characterMotion)
     case "transition":
       return trim(data.transition)
     case "style":

package/src/presentation-utils.ts

@@ -369,6 +369,7 @@ export const INPUT_FIELD_MAP: Record<string, InputFieldSchema> = {
   "post-process-effects": { key: "postProcess", type: "select" },
   "action-fx": { key: "actionFx", type: "select" },
   "character-fx": { key: "characterFx", type: "select" },
+  "character-motion": { key: "characterMotion", type: "select" },
   "transition": { key: "transition", type: "select" },
   "loop-subject": { key: "loopSubject", type: "select" },
   // --- Multi-dimension pickers: representative (first) field. Overriding only