@nodaro/prompts 1.38.0 → 1.40.0

package/src/seedance-2-inputs.ts

@@ -1,5 +1,5 @@
 import { SEEDANCE_2_REF_LIMITS } from "@nodaro/shared/models"
-import { REF_BINDING } from "./video-reference-resolver.js"
+import { placeFramesAfterReferences } from "./frame-reference-slots.js"
 
 export type Seedance2Mode = "first-frame" | "first-last-frame" | "reference"
 
@@ -46,18 +46,7 @@ const cleanList = (xs?: readonly string[]): string[] =>
  * reference_image_urls (after the user's own images, so their @Image ordinals do
  * not shift) and named in a doctrine-compliant prompt suffix.
  */
-/** True when the prompt ALREADY binds an image as the first/opening frame —
- *  e.g. the gvp overlap transport's colon-position directive ("use @image_1
- *  as the first frame, it is the last keyframe of @video_1"). Field finding
- *  (2026-07-20): the first-frame directive only works adjacent to the extend
- *  colon; a duplicate sentence at the END of the prompt (this resolver's
- *  default position) dilutes it back into coin-flip behavior — so when the
- *  prompt carries its own binding, the suffix is suppressed (the frame image
- *  itself still rides the reference list). */
-export function promptBindsFirstFrame(prompt: string | undefined): boolean {
-  if (!prompt) return false
-  return /@image_\d+\s+as\s+the\s+(first|opening)\s*(\(first\))?\s*frame/i.test(prompt)
-}
+export { promptBindsFirstFrame } from "./frame-reference-slots.js"
 
 export function resolveSeedance2Inputs(args: Seedance2InputsArgs): Seedance2InputsResult {
   const limits = args.limits ?? SEEDANCE_2_REF_LIMITS
@@ -85,33 +74,19 @@ export function resolveSeedance2Inputs(args: Seedance2InputsArgs): Seedance2Inpu
   }
 
   // Reference mode: keep both frames (explicit intent), drop trailing user images
-  // if the 9-image cap is exceeded. Frames are appended AFTER the kept user
-  // images so existing user @Image ordinals are preserved.
-  const frameCount = (firstFrameUrl ? 1 : 0) + (lastFrameUrl ? 1 : 0)
-  const userImageSlots = Math.max(0, limits.images - frameCount)
-  const keptUserImages = refImages.slice(0, userImageSlots)
-  const droppedRefImages = refImages.length - keptUserImages.length
-
-  const referenceImageUrls: string[] = [...keptUserImages]
-  let firstOrdinal = 0
-  let lastOrdinal = 0
-  if (firstFrameUrl) { referenceImageUrls.push(firstFrameUrl); firstOrdinal = referenceImageUrls.length }
-  if (lastFrameUrl) { referenceImageUrls.push(lastFrameUrl); lastOrdinal = referenceImageUrls.length }
-
-  let promptSuffix = ""
-  const suppressFrameSentence = promptBindsFirstFrame(args.prompt)
-  if (suppressFrameSentence && firstOrdinal > 0 && lastOrdinal === 0) {
-    // The prompt already binds the first frame at its own (working) position.
-  } else if (firstOrdinal > 0 && lastOrdinal > 0) {
-    // Combined sentence — REF_BINDING.frame() emits a single-frame sentence, so use
-    // REF_BINDING.ordinal() for each ordinal inline to keep the combined wording AND
-    // route both ordinals through the single swap-point.
-    promptSuffix = `Use ${REF_BINDING.ordinal(firstOrdinal)} as the opening (first) frame and ${REF_BINDING.ordinal(lastOrdinal)} as the closing (last) frame of the video.`
-  } else if (firstOrdinal > 0) {
-    promptSuffix = REF_BINDING.frame(firstOrdinal, "opening")
-  } else if (lastOrdinal > 0) {
-    promptSuffix = REF_BINDING.frame(lastOrdinal, "closing")
-  }
+  // if the image cap is exceeded. Frames are appended AFTER the kept user images
+  // so existing user @Image ordinals are preserved — the platform convention
+  // (placeFramesAfterReferences), shared with every frames-in-the-list model.
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl,
+    lastFrameUrl,
+    refImageUrls: refImages,
+    imageCap: limits.images,
+  })
+  const referenceImageUrls = placed.imageUrls
+  const promptSuffix = placed.promptSuffix
+  const droppedRefImages = placed.droppedRefImages
 
   return {
     mode: "reference",

package/src/user-direction-refs.ts

@@ -0,0 +1,110 @@
+/**
+ * USER-OWNED DIRECTION REFERENCES — a `direction` value that names one of the
+ * caller's own saved resources instead of a catalog id.
+ *
+ * Two rows of the direction registry take one (their `userRef` column):
+ *   - `colorLook: "palette:<uuid>"`  — a saved colour palette;
+ *   - `style:     "moodboard:<uuid>"` — a saved moodboard.
+ * The prefix namespaces them, so they never collide with a catalog id
+ * (catalog ids are slugs; none carries a colon).
+ *
+ * The wire carries the id, never the resolved text, so a re-run resolves it
+ * again and an edited palette reaches the next run. RESOLVING is a database
+ * read, so it happens in the platform before the (pure, synchronous) fold:
+ * the caller hands the fold a map of value → rendered clause
+ * (`renderDirectionHintClauses`' `refs`, `assembleImageInput`'s
+ * `directionRefs`), and a moodboard's images as fill-only style references
+ * (`assembleImageInput`'s `styleReferences`). This module holds what is pure:
+ * the grammar and the WORDING of those clauses and reference lines.
+ */
+import { nearestColorName } from "./color-names.js"
+
+/** The kinds of saved resource a direction value can name. */
+export type UserDirectionRefKind = "palette" | "moodboard"
+
+export const USER_DIRECTION_REF_KINDS: ReadonlyArray<UserDirectionRefKind> = ["palette", "moodboard"]
+
+/** A parsed user-owned reference. `wellFormed` = its id is a uuid. */
+export interface UserDirectionRef {
+  readonly kind: UserDirectionRefKind
+  readonly id: string
+  readonly wellFormed: boolean
+}
+
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+
+/**
+ * Read one direction value. `null` when it is not a user-owned reference at
+ * all (a catalog id, an empty string, anything that is not a string). A value
+ * with a known prefix is ALWAYS a reference — `wellFormed: false` when what
+ * follows is not a uuid, so a caller can refuse it rather than treat it as an
+ * unknown catalog id and skip it in silence.
+ */
+export function parseUserDirectionRef(value: unknown): UserDirectionRef | null {
+  if (typeof value !== "string") return null
+  for (const kind of USER_DIRECTION_REF_KINDS) {
+    const prefix = `${kind}:`
+    if (value.startsWith(prefix)) {
+      const id = value.slice(prefix.length)
+      return { kind, id, wellFormed: UUID_RE.test(id) }
+    }
+  }
+  return null
+}
+
+/** The wire value for a saved resource: `palette:<id>` / `moodboard:<id>`. */
+export function userDirectionRefValue(kind: UserDirectionRefKind, id: string): string {
+  return `${kind}:${id}`
+}
+
+/** Collapse all whitespace (newlines included) to single spaces and trim. User
+ *  text never opens a line of its own inside the assembled prompt — a newline
+ *  there could start a fake `[style]:` section. */
+function oneLine(text: string | null | undefined): string {
+  return (text ?? "").replace(/\s+/g, " ").trim()
+}
+
+const HEX_RE = /^#[0-9a-f]{6}$/i
+
+/**
+ * A saved palette as a look clause: every colour by its everyday name and its
+ * exact hex, in the palette's order — `color palette: dark teal #0F4C5C,
+ * saffron #E3B23C`. An entry that is not a `#RRGGBB` colour is skipped; no
+ * valid colour renders nothing.
+ */
+export function renderPaletteClause(colors: ReadonlyArray<string>): string {
+  const named = colors
+    .filter((c) => HEX_RE.test(c))
+    .map((c) => `${nearestColorName(c)} ${c.toUpperCase()}`)
+  return named.length > 0 ? `color palette: ${named.join(", ")}` : ""
+}
+
+/**
+ * A saved moodboard's written description as its look clause: the user's own
+ * words, on one line. No description renders nothing (the moodboard's images
+ * still go along as style references).
+ */
+export function renderMoodboardClause(description: string | null | undefined): string {
+  return oneLine(description)
+}
+
+/** One style reference image (a moodboard's image) handed to the assembler. */
+export interface StyleReferenceInput {
+  readonly url: string
+  /** What the image is for — rides its reference line. */
+  readonly caption?: string
+}
+
+/**
+ * The line a style reference carries in the assembled prompt (its
+ * `description` as a reference). The first one says what to take from a style
+ * reference and what not to; the rest stay short, so a full moodboard does not
+ * bury the prompt. A caption rides along on one line.
+ */
+export function styleReferenceDescription(index: number, caption?: string): string {
+  const cap = oneLine(caption)
+  const tail = cap ? ` (${cap})` : ""
+  return index === 0
+    ? `match the colors, light, texture and mood of this style reference${tail}, not its subject or layout`
+    : `another style reference${tail}`
+}

package/src/veo-i2v-inputs.ts

@@ -1,5 +1,4 @@
-import { promptBindsFirstFrame } from "./seedance-2-inputs.js"
-import { identityRefsSentence, REF_BINDING } from "./video-reference-resolver.js"
+import { placeFramesAfterReferences } from "./frame-reference-slots.js"
 
 /**
  * VEO 3.x i2v input resolution — the mutually-exclusive sibling of
@@ -8,13 +7,15 @@ import { identityRefsSentence, REF_BINDING } from "./video-reference-resolver.js
  * [first(, last)] frames; REFERENCE_2_VIDEO reads every entry as a
  * reference ingredient. Frames and identities cannot ride separate
  * channels, so an anchored call that must carry identity references moves
- * to REFERENCE_2_VIDEO with the anchor in seat 1, bound in prose as the
- * opening frame (requested, not pixel-guaranteed — the accepted trade,
- * same as seedance-2's reference mode).
+ * to REFERENCE_2_VIDEO with the frames bound in prose (requested, not
+ * pixel-guaranteed — the accepted trade, same as seedance-2's reference mode).
  *
- * REFERENCES WIN THE SEATS (the 2026-08-14 standing rule: refs are a must,
- * frames additional): the end anchor is dropped in reference mode rather
- * than spending one of three seats on a closing guess. The caller logs it.
+ * THE PLATFORM CONVENTION (2026-10-18, `placeFramesAfterReferences`): the
+ * caller's references take the first seats, so their image token N is their
+ * Nth reference; the start frame — and the end frame, VEO takes one — follow
+ * them, bound as the opening / closing frame. At the 3-ingredient cap the
+ * frames are kept (explicit intent) and trailing references drop, reported.
+ * (Until then the anchor took seat 1 and an end frame was surrendered.)
  *
  * BYTE-IDENTICAL with no references: plain frame mode, frames kept, no
  * generationType, no suffix — exactly what every veo i2v call has always
@@ -30,14 +31,15 @@ export interface VeoI2vInputsArgs {
 }
 
 export interface VeoI2vInputsResult {
-  /** The `imageUrls` payload: frames in plain mode, [anchor, ...refs] in
+  /** The `imageUrls` payload: frames in plain mode, [...refs, start, end?] in
    *  reference mode — never more than VEO's 3-ingredient cap. */
   imageUrls: string[]
   /** Present (REFERENCE_2_VIDEO) exactly when references ride. */
   generationType?: "REFERENCE_2_VIDEO"
   promptSuffix: string
   droppedRefImages: number
-  /** True when an end anchor was surrendered to reference mode. */
+  /** Always false since the frames-after-references convention: an end frame
+   *  is kept in reference mode. Kept for callers that log it. */
   droppedEndFrame: boolean
 }
 
@@ -55,14 +57,19 @@ export function resolveVeoI2vInputs(args: VeoI2vInputsArgs): VeoI2vInputsResult
       droppedEndFrame: false,
     }
   }
-  const kept = refs.slice(0, VEO_INGREDIENT_SLOTS - 1)
-  const droppedRefImages = refs.length - kept.length
-  const frameSentence = promptBindsFirstFrame(args.prompt) ? "" : REF_BINDING.frame(1, "opening")
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl: args.firstFrameUrl,
+    lastFrameUrl: args.endFrameUrl,
+    refImageUrls: refs,
+    imageCap: VEO_INGREDIENT_SLOTS,
+    bindIdentities: true,
+  })
   return {
-    imageUrls: [args.firstFrameUrl, ...kept],
+    imageUrls: placed.imageUrls,
     generationType: "REFERENCE_2_VIDEO",
-    promptSuffix: [frameSentence, identityRefsSentence(2, kept.length + 1)].filter(Boolean).join(" "),
-    droppedRefImages,
-    droppedEndFrame: Boolean(args.endFrameUrl),
+    promptSuffix: placed.promptSuffix,
+    droppedRefImages: placed.droppedRefImages,
+    droppedEndFrame: false,
   }
 }

package/src/video-reference-resolver.ts

@@ -54,7 +54,7 @@ import { tidyReferenceTokenGaps, unboundReferenceTokenText } from "./unbound-ref
 // The binding surface string and the id-addressed token resolver live in their
 // own modules (see them for the contracts); re-exported here so every existing
 // importer of this module — and the package index's `export *` — keeps working.
-export { REF_BINDING, identityRefsSentence, SEEDANCE_VIDEO_EDIT_PREFIX, buildSeedanceVideoEditPrompt } from "./ref-binding.js"
+export { REF_BINDING, identityRefsSentence, imageBindingFor, SEEDANCE_VIDEO_EDIT_PREFIX, buildSeedanceVideoEditPrompt, type ImageBinding } from "./ref-binding.js"
 export { resolveRefIdTokens, type RefIdTokenContext } from "./ref-id-tokens.js"
 
 

package/dist/chunk-4FDNVNJE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resolve-prompt.ts","../src/audio-tags.ts","../src/node-prompt-fields.ts","../src/node-send-text.ts"],"names":["SOCIAL_POST_NODE_TYPES","present","resolveNodeRefs"],"mappings":"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","file":"chunk-4FDNVNJE.js","sourcesContent":["import { resolveNodeRefs } from \"@nodaro/shared/workflow\"\nimport { readPromptAffixes, type PromptAffixes } from \"@nodaro/shared/nodes\"\nimport { SOCIAL_POST_NODE_TYPES } from \"@nodaro/shared/social\"\nimport { joinSentences } from \"./hint-join.js\"\n\nexport interface ResolvePromptArgs {\n  override?: string\n  typed?: ReadonlyArray<string | undefined>\n  wired?: string\n  refMap: ReadonlyMap<string, string>\n  /** Opt-in (generate-image / generate-video only): APPEND the wired\n   *  (connected-prompt) value to the TYPED base instead of treating wired as a\n   *  fallback, so a connected prompt auto-injects alongside the typed prompt. An\n   *  `override` (list fan-out item) still fully replaces — no wired append.\n   *  Off/undefined = exact legacy precedence (override > typed > wired) for every\n   *  other node type. */\n  appendWired?: boolean\n  /** Pre/post text wrapped around WHICHEVER core precedence produced (override,\n   *  typed, wired, or the appendWired combination). Applied last. */\n  affixes?: PromptAffixes\n}\nconst present = (s?: string): s is string => typeof s === \"string\" && s.trim().length > 0\nconst rr = (s: string, m: ReadonlyMap<string, string>) => (m.size > 0 ? resolveNodeRefs(s, m) : s)\n\n// ---------------------------------------------------------------------------\n// Prompt affixes (pre/post text) — see docs/prompt-pre-post-text.md (join rule, empty-core, no-op guarantee)\n// ---------------------------------------------------------------------------\n\nconst GLUE_PUNCTUATION = new Set([\",\", \".\", \";\", \":\", \"!\", \"?\", \")\"])\n\n/** The ONE join rule between two non-blank prompt parts: a single space unless\n *  the boundary already has whitespace on either side or the right part opens\n *  with sentence punctuation. Shared by `joinPromptParts` and the editor's\n *  Final-view segment builder so preview and run agree byte-for-byte. */\nexport function promptPartSeparator(left: string, right: string): \"\" | \" \" {\n  if (left.length === 0 || right.length === 0) return \"\"\n  if (/\\s$/.test(left) || /^\\s/.test(right)) return \"\"\n  if (GLUE_PUNCTUATION.has(right[0])) return \"\"\n  return \" \"\n}\n\n/** Join prompt parts with `promptPartSeparator`; blank parts are dropped,\n *  non-blank parts are used verbatim (no trimming). */\nexport function joinPromptParts(parts: ReadonlyArray<string | undefined>): string {\n  let out = \"\"\n  for (const part of parts) {\n    if (!present(part)) continue\n    out = out.length === 0 ? part : out + promptPartSeparator(out, part) + part\n  }\n  return out\n}\n\n/**\n * Wrap `core` with the node's pre/post text. `{Label}` refs are resolved in the\n * AFFIXES only — the core arrives exactly as the caller's precedence produced it.\n * NO-OP GUARANTEE: with no non-blank affix the core is returned unchanged (same\n * reference) — every existing workflow stays byte-identical.\n * EMPTY CORE: a blank core with affixes yields the joined affixes alone.\n */\nexport function applyPromptAffixes(core: string, affixes: PromptAffixes | undefined, refMap: ReadonlyMap<string, string>): string\nexport function applyPromptAffixes(core: string | undefined, affixes: PromptAffixes | undefined, refMap: ReadonlyMap<string, string>): string | undefined\nexport function applyPromptAffixes(\n  core: string | undefined,\n  affixes: PromptAffixes | undefined,\n  refMap: ReadonlyMap<string, string>,\n): string | undefined {\n  const prefix = present(affixes?.prefix) ? rr(affixes!.prefix!, refMap) : undefined\n  const suffix = present(affixes?.suffix) ? rr(affixes!.suffix!, refMap) : undefined\n  if (prefix === undefined && suffix === undefined) return core\n  return joinPromptParts([prefix, core, suffix])\n}\n\n/** SINGLE SOURCE OF TRUTH for prompt precedence across both DAG engines:\n *  override (list fan-out) > first present typed candidate > wired > \"\".\n *  \"present\" = non-empty after trim. {Label} refs are resolved on the chosen\n *  branch via the shared resolveNodeRefs. With `appendWired`, the chosen base\n *  AND the wired value are both emitted, joined as sentences (`joinSentences`:\n *  \". \", or a space after one that already ends). Affixes wrap the result. */\nexport function resolvePrompt({ override, typed = [], wired, refMap, appendWired, affixes }: ResolvePromptArgs): string {\n  return applyPromptAffixes(resolveCore({ override, typed, wired, refMap, appendWired }), affixes, refMap)\n}\n\nfunction resolveCore({ override, typed = [], wired, refMap, appendWired }: Omit<ResolvePromptArgs, \"affixes\">): string {\n  // appendWired: a connected prompt APPENDS to the TYPED base. An `override`\n  // (list fan-out item) still fully REPLACES — it never receives a wired append,\n  // so per-item fan-out prompts are unchanged.\n  if (appendWired && !present(override)) {\n    const base = typed.find(present)\n    return joinSentences([base, wired].filter(present).map((s) => rr(s, refMap)))\n  }\n  if (present(override)) return rr(override, refMap)\n  for (const t of typed) if (present(t)) return rr(t, refMap)\n  if (present(wired)) return rr(wired, refMap)\n  return \"\"\n}\n\n/** Compose a final NEGATIVE prompt from a TYPED base + a WIRED (connected\n *  negative-handle) value: both are emitted, joined as sentences (`joinSentences`, mirrors `appendWired`\n *  for the positive prompt). Pure join — the caller resolves `{label}` refs on\n *  the typed value first, and the wired value is already a resolved output that\n *  the input-resolver has filtered (referenced / Inject-Negative-off dropped).\n *  Generate-image / generate-video only; empty parts are dropped. */\nexport function composeNegative(typed?: string, wired?: string): string {\n  return joinSentences([typed, wired])\n}\n\n/** Ordered typed-candidate fields per node type — the precedence source of\n *  truth (NOT NODE_MAPPABLE_FIELDS, which is field-mapping eligibility, omits\n *  video-retake, and orders llm-chat wrong). */\nexport const NODE_PROMPT_CANDIDATE_FIELDS: Readonly<Record<string, readonly string[]>> = {\n  \"generate-image\": [\"prompt\"],\n  // motionPrompt is here so generate-video re-typed to text-to-video keeps a\n  // prompt stored in data.motionPrompt (the inline picker's legacy field). Safe\n  // for a standalone text-to-video node — it never carries data.motionPrompt.\n  \"text-to-video\": [\"prompt\", \"motionPrompt\"],\n  \"video-to-video\": [\"prompt\"],\n  \"generate-music\": [\"prompt\"],\n  \"speech-to-video\": [\"prompt\"],\n  \"cinematic-avatar\": [\"prompt\"],\n  \"extend-video\": [\"prompt\"],\n  \"video-retake\": [\"prompt\"],\n  \"suno-replace-section\": [\"prompt\"],\n  \"image-to-video\": [\"prompt\", \"motionPrompt\"],\n  \"generate-video\": [\"prompt\", \"motionPrompt\"],\n  \"text-to-audio\": [\"prompt\", \"text\"],\n  // Social posts: the orchestrator + frontend executor match per-platform node\n  // types (node.type is \"instagram-post\", \"telegram-post\", …), NOT a unified\n  // \"social-publish\" type — so every platform needs its own [\"caption\"] entry.\n  // Derived from the shared SOCIAL_POST_NODE_TYPES single source of truth so a\n  // new platform can't drift out of the precedence map.\n  ...Object.fromEntries(\n    [...SOCIAL_POST_NODE_TYPES].map((t) => [t, [\"caption\"] as readonly string[]]),\n  ),\n  // Kept for any caller that passes the aggregate type instead of a platform.\n  \"social-publish\": [\"caption\"],\n}\n\nexport interface ComputeNodePromptArgs {\n  override?: string\n  wired?: string\n  refMap: ReadonlyMap<string, string>\n  /** See ResolvePromptArgs.appendWired — generate-image / generate-video only. */\n  appendWired?: boolean\n}\n/** Resolve a single-prompt node's final prompt (typed-primary). Both engines\n *  call this so field-selection + precedence are structurally identical. */\nexport function computeNodePrompt(\n  nodeType: string,\n  data: Record<string, unknown>,\n  { override, wired, refMap, appendWired }: ComputeNodePromptArgs,\n): string {\n  let typed: ReadonlyArray<string | undefined>\n  if (nodeType === \"text-to-speech\") {\n    // data.text is a phantom field on TTS; only directText (gated) is real.\n    //\n    // The gate is a PREFERENCE, not a lock: when textSource is \"connected\" we\n    // still fall back to typed text if nothing is wired. Writers flip the gate\n    // (PromptFieldSpec.promptGate), but data reaches nodes from places no\n    // writer touches — workflows saved before that fix, JSON imports, MCP\n    // writes, templates — and there the text sat visible in the node while the\n    // run failed with \"no text found\" (founder, 2026-08-14). Coerce rather\n    // than reject, same principle as normalizeModelInput.\n    typed =\n      data.textSource === \"direct\" || !present(wired)\n        ? [data.directText as string | undefined]\n        : []\n  } else {\n    const fields = NODE_PROMPT_CANDIDATE_FIELDS[nodeType] ?? [\"prompt\"]\n    typed = fields.map((f) => data[f] as string | undefined)\n  }\n  return resolvePrompt({ override, typed, wired, refMap, appendWired, affixes: readPromptAffixes(data) })\n}\n\nexport interface LlmChatFieldArgs {\n  override?: string\n  wiredUserInput?: string\n  wiredSystemPrompt?: string\n  refMap: ReadonlyMap<string, string>\n}\n/** llm-chat resolves TWO independent fields. override applies to userInput only. */\nexport function computeLlmChatFields(\n  data: Record<string, unknown>,\n  { override, wiredUserInput, wiredSystemPrompt, refMap }: LlmChatFieldArgs,\n): { userInput: string; systemPrompt: string } {\n  return {\n    userInput: resolvePrompt({ override, typed: [data.userInput as string | undefined], wired: wiredUserInput, refMap, affixes: readPromptAffixes(data) }),\n    systemPrompt: resolvePrompt({ typed: [data.systemPrompt as string | undefined], wired: wiredSystemPrompt, refMap }),\n  }\n}\n\n/** generate-script's topic. Both engines call this, so a wired Text node reads\n *  the same on a single-node run and a server run.\n *\n *  Precedence is override (a list fan-out item) > wired > `data.prompt`. Wired\n *  comes BEFORE the typed field, the reverse of `computeNodePrompt`, because\n *  `data.prompt` has no editor: the panel's text field is the style guide. A\n *  value there was written by the old connect-time `{Label}` auto-fill or by an\n *  agent, and it is kept only as the fallback that saved workflows rely on. */\nexport function computeScriptTopic(\n  data: Record<string, unknown>,\n  { override, wired, refMap }: Omit<ComputeNodePromptArgs, \"appendWired\">,\n): string {\n  const core = [override, wired, data.prompt as string | undefined].find(present)\n  return applyPromptAffixes(core === undefined ? \"\" : rr(core, refMap), readPromptAffixes(data), refMap)\n}\n","/**\n * Remove inline `[audio tags]` from speech text, for a model that does not\n * perform them (it would read them aloud). Pure, dependency-free: the\n * backend's credit counter (lib/speech-credits.ts), its payload builder and\n * the editor's estimate (frontend/src/lib/speech-estimate.ts) all read it, so\n * the two engines count exactly the same characters.\n *\n * A tag is `[`, one or more characters that are not `]`, then `]` — what\n * `/\\[[^\\]]+\\]/g` matches. That pattern is quadratic on an unclosed run of `[`\n * (every `[` rescans to the end of the text), and the credit counter runs this\n * on raw request text on the API and orchestrator event loops, so the scan is\n * written by hand: one `indexOf` per `[`, and when no `]` is left no later `[`\n * can match either, so the rest of the text is kept in one slice.\n */\nfunction removeBracketTags(text: string): string {\n  let out = \"\"\n  let from = 0\n  let open = text.indexOf(\"[\")\n  while (open !== -1) {\n    const close = text.indexOf(\"]\", open + 1)\n    if (close === -1) break\n    if (close === open + 1) {\n      // \"[]\" is not a tag (needs 1+ characters); the \"[\" stays and the scan moves on.\n      open = text.indexOf(\"[\", open + 1)\n      continue\n    }\n    out += text.slice(from, open)\n    from = close + 1\n    open = text.indexOf(\"[\", from)\n  }\n  return out + text.slice(from)\n}\n\nexport function stripAudioTags(text: string): string {\n  return removeBracketTags(text).replace(/\\s{2,}/g, \" \").trim()\n}\n","/**\n * Single source of truth: which data field(s) hold a node's user-editable\n * prompt text. Drives the quick-edit Prompt modal so it can work generically\n * across every AI node without each call site hardcoding a field name.\n *\n * The registry LIVES HERE (`@nodaro/prompts`) so the backend orchestrator, the\n * `/v1/nodes` registry, the prompt-affix totality tests and the docs tooling\n * read the SAME list the editor does. `frontend/src/lib/prompt-fields.ts` is a\n * pure re-export of this module — frontend code keeps importing\n * `@/lib/prompt-fields` unchanged.\n *\n * Most nodes store the prompt in `data.prompt`, but several don't\n * (`text-prompt` → `text`, `image-to-text` → `customPrompt`, …) — this map is\n * where that knowledge lives, once.\n *\n * INVARIANT: every node that exposes a user-editable prompt MUST have an entry\n * here, or the quick-edit modal silently does nothing for it. A guard test\n * (`prompt-fields.test.ts`) keeps this in sync with the node set.\n *\n * This module is intentionally pure data (no React/lucide imports) so it can be\n * pulled into the app-runtime bundle and any test without dragging in the icon\n * library. The string `icon` kind is mapped to a concrete lucide component in\n * `prompt-edit-button.tsx` (`getPromptIcon`), the only place that renders it.\n */\n\nimport type { SnippetMedia } from \"./factory-snippets/types.js\"\nimport { NODE_PROMPT_CANDIDATE_FIELDS } from \"./resolve-prompt.js\"\n\n/** Which lucide glyph a node's prompt affordance uses. Kept as a string so this\n *  module stays icon-library-free; mapped to a component in the strip button. */\nexport type PromptIconKind = \"pencil\" | \"paintbrush\"\n\nexport interface PromptFieldSpec {\n  /** Data key holding the primary prompt (e.g. \"prompt\", \"text\", \"customPrompt\"). */\n  readonly prompt: string\n  /** Data key holding the negative prompt, when the node supports one. */\n  readonly negative?: string\n  /** Label override for the primary field (defaults to \"Prompt\"). */\n  readonly promptLabel?: string\n  /** Icon for the prompt affordance (strip button + modal title). Defaults to a\n   *  pencil; image-editing nodes use a paintbrush to read as \"edit\". */\n  readonly icon?: PromptIconKind\n  /** Node modality for prompt-snippet scoping — drives which snippet pool the\n   *  \"/\" menu and Snippets button show for this node's prompt fields. REQUIRED\n   *  so a new node cannot forget to declare it (compile error). */\n  readonly media: SnippetMedia\n  /** True when this node renders a media-result preview body and therefore\n   *  participates in inline-prompt mode (the `InlineNodePrompt` editor on the\n   *  node face, centralized in `BaseNode`). REQUIRED (like `media`) so a new\n   *  prompt node must consciously choose — compile error if omitted. The set of\n   *  `inline: true` types is guarded in `prompt-fields.test.ts`. */\n  readonly inline: boolean\n  /** Some nodes only READ their prompt field when a sibling discriminator\n   *  selects it — TTS keeps `directText` but resolves it only while\n   *  `textSource === \"direct\"`, defaulting to `\"connected\"`. Writing the text\n   *  without flipping the discriminator saved the value and then failed with\n   *  \"no text found\" (founder hit it live, 2026-08-14). Declare the pair here\n   *  and every writer flips it automatically. */\n  readonly promptGate?: { readonly field: string; readonly value: string }\n  /** Prompt pre/post text (`promptPrefix` / `promptSuffix`) support. Defaults to\n   *  ON for every prompt node; set `false` ONLY for a node whose \"prompt\" is not\n   *  a model prompt (the plain Text input node). Read via `nodeSupportsPromptAffixes`. */\n  readonly affixes?: false\n}\n\nexport const NODE_PROMPT_FIELDS: Readonly<Record<string, PromptFieldSpec>> = {\n  // ── Image ──\n  // (`edit-image` / `image-to-image` are legacy types consolidated into\n  // `modify-image`; they're not in the creatable node set, so a node of that\n  // type never mounts and needs no entry here. The guard test enforces that.)\n  \"generate-image\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"image\", inline: true },\n  \"modify-image\": { prompt: \"prompt\", negative: \"negativePrompt\", icon: \"paintbrush\", media: \"image\", inline: true },\n  \"generate-mask\": { prompt: \"prompt\", promptLabel: \"What to mask\", media: \"image\", inline: true },\n  // ── Video ──\n  \"generate-video\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"video\", inline: true },\n  // Trimmed multi-segment stitch sibling of generate-video — no negativePrompt field.\n  \"generate-video-pro\": { prompt: \"prompt\", media: \"video\", inline: true },\n  // Span-replace sibling of generate-video-pro — no negativePrompt field.\n  \"edit-video-pro\": { prompt: \"prompt\", media: \"video\", inline: true },\n  \"text-to-video\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"video\", inline: true },\n  \"image-to-video\": { prompt: \"prompt\", negative: \"negativePrompt\", promptLabel: \"Motion prompt\", media: \"video\", inline: true },\n  \"video-to-video\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"video\", inline: true },\n  \"switchx\": { prompt: \"prompt\", promptLabel: \"Look prompt\", media: \"video\", inline: true },\n  \"extend-video\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"video\", inline: true },\n  \"speech-to-video\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"video\", inline: true },\n  \"motion-transfer\": { prompt: \"prompt\", negative: \"negativePrompt\", media: \"video\", inline: true },\n  // Cinematic Avatar (HeyGen) — generative prompt (NOT a verbatim script),\n  // so it participates in the quick-edit Prompt modal like other AI video nodes.\n  \"cinematic-avatar\": { prompt: \"prompt\", media: \"video\", inline: true },\n  \"video-sfx\": { prompt: \"prompt\", negative: \"negativePrompt\", promptLabel: \"Sound prompt\", media: \"audio\", inline: true },\n  \"video-retake\": { prompt: \"prompt\", promptLabel: \"Retake prompt\", media: \"video\", inline: true },\n  // Video Mask (SAM 3) — the subject to track, like Generate Mask's \"what to mask\".\n  \"video-mask\": { prompt: \"prompt\", promptLabel: \"What to mask\", media: \"video\", inline: true },\n  // ── Audio / music ──\n  \"generate-music\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  \"suno-generate\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  \"text-to-audio\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  // ── Text / LLM (no media-result preview body → no inline editor) ──\n  \"text-prompt\": { prompt: \"text\", promptLabel: \"Text\", media: \"text\", inline: false, affixes: false },\n  \"image-to-text\": { prompt: \"customPrompt\", promptLabel: \"Question\", media: \"text\", inline: false },\n  \"llm-chat\": { prompt: \"userInput\", promptLabel: \"Prompt\", media: \"text\", inline: false },\n  // ── Speech / voice ──\n  \"text-to-speech\": { prompt: \"directText\", promptLabel: \"Text\", media: \"audio\", inline: true, promptGate: { field: \"textSource\", value: \"direct\" } },\n  \"voice-design\": { prompt: \"voiceDescription\", promptLabel: \"Voice description\", media: \"audio\", inline: true },\n  \"voice-remix\": { prompt: \"voiceDescription\", promptLabel: \"Voice description\", media: \"audio\", inline: true },\n  \"lip-sync\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  // ── Suno (music) ──\n  \"suno-cover\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  \"suno-extend\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  \"suno-replace-section\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  \"suno-upload-extend\": { prompt: \"prompt\", media: \"audio\", inline: true },\n  // NOTE: `suno-add-vocals` is intentionally absent — its node has no\n  // user-editable prompt (SunoAddVocalsData declares only `model`; the config\n  // panel + backend route take taskId/audioId/model, never a prompt). A stale\n  // entry here rendered a phantom Prompt editor in the quick-edit modal that\n  // wrote to a `data.prompt` key nothing ever reads (the dead-field class the\n  // guard test now catches via defaultData ownership).\n  \"suno-lyrics\": { prompt: \"prompt\", media: \"audio\", inline: false },\n  \"suno-style-boost\": { prompt: \"content\", promptLabel: \"Style\", media: \"audio\", inline: false },\n  // ── Composition / FX (compact, no media-result preview → no inline editor) ──\n  \"image-critic\": { prompt: \"prompt\", promptLabel: \"Criteria\", media: \"image\", inline: false },\n  \"motion-graphics\": { prompt: \"motionPrompt\", promptLabel: \"Motion prompt\", media: \"video\", inline: false },\n  \"pro-3d-render\": { prompt: \"scenePrompt\", promptLabel: \"Scene\", media: \"text\", inline: false },\n  \"generate-3d-scene\": { prompt: \"scenePrompt\", promptLabel: \"Scene\", media: \"text\", inline: false },\n  \"edit-3d-scene\": { prompt: \"editPrompt\", promptLabel: \"Edit instruction\", media: \"text\", inline: false },\n  \"3d-title\": { prompt: \"titlePrompt\", promptLabel: \"Title\", media: \"text\", inline: false },\n  // ── Script / alignment (their primary text field) ──\n  \"generate-script\": { prompt: \"styleGuide\", promptLabel: \"Style guide\", media: \"text\", inline: false },\n  \"forced-alignment\": { prompt: \"transcript\", promptLabel: \"Transcript\", media: \"audio\", inline: false },\n  // Video Analysis — its focus hint is the editable prompt (renders a JSON scene\n  // table, not a media preview → no inline editor).\n  \"video-analysis\": { prompt: \"analysisFocus\", promptLabel: \"Analysis focus\", media: \"video\", inline: false },\n  // Edit Plan (podcast editing) — its free-text editing instructions are the\n  // editable prompt; the affixes wrap them. Emits an EDL (JSON), not a media\n  // preview, so no inline editor.\n  \"edit-plan\": { prompt: \"instructions\", promptLabel: \"Editing instructions\", media: \"video\", inline: false },\n}\n\n/** The prompt-field spec for a node type, or undefined if it has none. */\nexport function getPromptFields(nodeType: string | undefined): PromptFieldSpec | undefined {\n  return nodeType ? NODE_PROMPT_FIELDS[nodeType] : undefined\n}\n\n/** True when this node type has a registered, quick-editable prompt field. */\nexport function nodeHasPromptField(nodeType: string | undefined): boolean {\n  return getPromptFields(nodeType) !== undefined\n}\n\n/** Snippet modality for a node type (drives the snippet pool), or undefined\n *  when the node has no prompt field. */\nexport function getSnippetMedia(nodeType: string | undefined): SnippetMedia | undefined {\n  return getPromptFields(nodeType)?.media\n}\n\n/** True when this node type renders the inline on-node prompt editor — the\n *  media-preview nodes (image/video/audio result body). Single source for\n *  BaseNode's centralized `InlineNodePrompt` rendering and the gold nodes'\n *  `showInline` derivation (`useInlinePromptActive`). */\nexport function nodeHasInlinePrompt(nodeType: string | undefined): boolean {\n  return getPromptFields(nodeType)?.inline === true\n}\n\n/** True when the node type carries `promptPrefix` / `promptSuffix` — every\n *  registered prompt node except explicit opt-outs (`affixes: false`). The single\n *  predicate the config panel, Final view, `/v1/nodes` registry, totality tests\n *  and docs tooling all gate on. */\nexport function nodeSupportsPromptAffixes(nodeType: string | undefined): boolean {\n  const spec = getPromptFields(nodeType)\n  return spec !== undefined && spec.affixes !== false\n}\n\n/**\n * Where the RUN-TIME prompt lives when it differs from the editor's prompt\n * field (spec §7). `generate-script`'s editable prompt is its `styleGuide`, but\n * the run wraps the topic `prompt` with the affixes — so previewing the style\n * guide must NOT show them.\n */\nexport const PROMPT_AFFIX_CORE_FIELD_OVERRIDES: Readonly<Record<string, string>> = { \"generate-script\": \"prompt\" }\n\n/** The data key whose value the run wraps with promptPrefix/promptSuffix, or\n *  undefined when the node has no affixes. */\nexport function promptAffixCoreField(nodeType: string | undefined): string | undefined {\n  if (!nodeSupportsPromptAffixes(nodeType)) return undefined\n  return PROMPT_AFFIX_CORE_FIELD_OVERRIDES[nodeType!] ?? getPromptFields(nodeType)!.prompt\n}\n\n/**\n * True when a preview of `promptField` on this node must show the affixes —\n * i.e. that key is what the run actually wraps. THE gate for the editor's Final\n * view, so a sibling field (llm-chat's `systemPrompt`, generate-script's\n * `styleGuide`) never renders a wrap the run doesn't perform.\n *\n * Two ways a key qualifies:\n *  - it IS the core field ({@link promptAffixCoreField}), or\n *  - it is a run-time FALLBACK candidate for the type\n *    ({@link NODE_PROMPT_CANDIDATE_FIELDS}) — `computeNodePrompt` picks the\n *    first present candidate and wraps THAT, so i2v's legacy `motionPrompt`\n *    genuinely receives the affixes when `data.prompt` is empty.\n *\n * The two rules never collide: no override type declares candidates (guarded in\n * `node-prompt-fields.test.ts`).\n *\n * `undefined` means \"the node's primary prompt field\" — the common call.\n */\nexport function promptFieldCarriesAffixes(nodeType: string | undefined, promptField: string | undefined): boolean {\n  const core = promptAffixCoreField(nodeType)\n  if (core === undefined) return false\n  if (promptField === undefined) return getPromptFields(nodeType)!.prompt === core\n  return promptField === core || (NODE_PROMPT_CANDIDATE_FIELDS[nodeType!] ?? []).includes(promptField)\n}\n\n/** The affix-capable node types, derived from the registry (never hand-listed). */\nexport const PROMPT_AFFIX_NODE_TYPES: ReadonlySet<string> = new Set(\n  Object.entries(NODE_PROMPT_FIELDS).filter(([, s]) => s.affixes !== false).map(([t]) => t),\n)\n","import { resolveNodeRefs } from \"@nodaro/shared/workflow\"\nimport { SOCIAL_POST_NODE_TYPES } from \"@nodaro/shared/social\"\nimport { computeLlmChatFields, computeNodePrompt, computeScriptTopic } from \"./resolve-prompt.js\"\n\n/**\n * Output nodes that send exactly what is WIRED into them — a webhook's\n * parameters, a social post's caption and media. When every wire produced\n * nothing in this run (a Filter List that kept no row, a node that was itself\n * skipped), there is nothing to send: the node is skipped with\n * `skipReason: \"empty_input\"` instead of posting an empty payload (a site that\n * validates its input answers 400 and alerts its owner) or failing the run\n * (a publish route refuses a post with no text and no media). A typed caption\n * with no wire at all is the author's choice and still runs, as before. ONE\n * list, read by the orchestrator's skip rule (`empty-input-skips.ts`).\n */\nexport const WIRED_OUTPUT_NODE_TYPES: ReadonlySet<string> = new Set([\"webhook-output\", ...SOCIAL_POST_NODE_TYPES])\n\n/**\n * Node types that send TEXT to a model or a voice and fail on an empty one —\n * `userInput: Too small` (llm-chat), \"no text found\" (text-to-speech) — so a\n * run with nothing upstream can skip them instead of failing. Never an image\n * or video node (an empty prompt is a legal request there) and never a social\n * post (an empty caption is the author's choice). ONE list, read by the\n * orchestrator's skip rule (`empty-input-skips.ts`); the engine never names a\n * type on its own.\n */\nexport const TEXT_REQUIRED_NODE_TYPES: ReadonlySet<string> = new Set([\n  \"llm-chat\",\n  \"ai-writer\",\n  \"generate-script\",\n  \"text-to-speech\",\n  \"generate-music\",\n  \"text-to-audio\",\n  // Save to Collection refuses an empty record (\"nothing to save\"): a feed\n  // with nothing new wired straight into it must skip it, not fail the run.\n  \"collection-write\",\n  // Generate Image: an empty prompt is a legal request in general (references\n  // alone), but when the text it was WIRED produced nothing this run — the skip\n  // rule's precondition — an empty prompt is a paid picture of nothing.\n  \"generate-image\",\n])\n\n/**\n * The node's data without its prompt pre/post text: the skip decision is about\n * the CORE text. A prefix alone (\"Write a news item about:\") is not something\n * to send — with the affixes applied, an empty core read as non-empty and an\n * idle tick paid for a model call on the prefix.\n */\nconst withoutAffixes = (data: Record<string, unknown>): Record<string, unknown> => ({ ...data, promptPrefix: undefined, promptSuffix: undefined })\n\nexport interface NodeSendTextArgs {\n  /** A list fan-out item (highest precedence). */\n  override?: string\n  /** The text wired into the node's main text input. */\n  wired?: string\n  /** llm-chat only: the text wired into `system-prompt`. */\n  wiredSystemPrompt?: string\n  refMap: ReadonlyMap<string, string>\n}\n\nconst present = (s?: string): s is string => typeof s === \"string\" && s.trim().length > 0\n\n/**\n * ai-writer's user input — the rule its sync-HTTP body applies: a fan-out\n * item, else the wired text, else the typed `userInput`, else the legacy\n * `prompt`. (ai-writer is renamed to llm-chat on load; saved graphs that\n * never reloaded still run it.)\n */\nexport function computeAiWriterInput(\n  data: Record<string, unknown>,\n  { override, wired }: Pick<NodeSendTextArgs, \"override\" | \"wired\">,\n): string {\n  return [override, wired, data.userInput as string | undefined, data.prompt as string | undefined].find(present) ?? \"\"\n}\n\n/**\n * The text a text-requiring node would send, by the SAME rule its executor\n * uses (`computeLlmChatFields`, `computeScriptTopic`, `computeNodePrompt`,\n * `computeAiWriterInput`) — so \"would this node run on nothing?\" is answered\n * by the function that decides what it sends, not by a second reading of it.\n * Undefined for any other node type.\n */\nexport function computeNodeSendText(\n  nodeType: string,\n  data: Record<string, unknown>,\n  args: NodeSendTextArgs,\n): string | undefined {\n  const bare = withoutAffixes(data)\n  switch (nodeType) {\n    case \"llm-chat\":\n      return computeLlmChatFields(bare, {\n        override: args.override,\n        wiredUserInput: args.wired,\n        wiredSystemPrompt: args.wiredSystemPrompt,\n        refMap: args.refMap,\n      }).userInput\n    case \"ai-writer\":\n      return computeAiWriterInput(bare, args)\n    case \"generate-script\":\n      return computeScriptTopic(bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n    case \"generate-music\": {\n      // A music node sings typed lyrics with no prompt; only both empty is nothing to send.\n      const prompt = computeNodePrompt(nodeType, bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n      return present(prompt) ? prompt : present(data.lyrics as string | undefined) ? (data.lyrics as string) : \"\"\n    }\n    case \"text-to-speech\":\n    case \"text-to-audio\":\n    case \"generate-image\":\n      return computeNodePrompt(nodeType, bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n    case \"collection-write\": {\n      // The record's content: the item (a fan-out row, else what reached `in`),\n      // else a title, text or link typed on the node. A picture alone is a\n      // record too, but it never starves the node: only a wired TEXT input that\n      // produced nothing can (the skip rule's precondition).\n      // A typed field counts as the engines send it, its `{Node}` references\n      // resolved: `{Feed || }` over a feed with nothing new is empty, so the\n      // node skips instead of failing with an empty record (#1890).\n      const typed = [data.title, data.text, data.link]\n        .map((v) => (typeof v === \"string\" ? resolveNodeRefs(v, args.refMap) : v))\n        .find((v): v is string => present(v as string | undefined))\n      return [args.override, args.wired, typed].find(present) ?? \"\"\n    }\n    default:\n      return undefined\n  }\n}\n"]}

package/dist/chunk-7XKHDXCL.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/read-node-direction.ts"],"names":["DIRECTION_FIELDS","DIRECTION_ID_MAX_CHARS","DIRECTION_ARRAY_CEILING","getRegisteredSubjectKeys","SUBJECT_CUSTOM_AGE_KEY","SUBJECT_ID_MAX_CHARS","SUBJECT_ARRAY_CEILING"],"mappings":"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","file":"chunk-7XKHDXCL.cjs","sourcesContent":["/**\n * Narrow readers turning UNTRUSTED persisted node data (`workflows.nodes`\n * JSONB — import, MCP write, node preset, a Studio-emitted graph) into the\n * typed `subject` / `direction` / `structured` levers `assembleImageInput`\n * accepts.\n * `buildPayload` has no zod and workflow writes are\n * `z.record(z.string(), z.unknown())`, so this blob may have been written years\n * ago by any client.\n *\n * Used by ALL THREE image-assembly sites so what the canvas accepts cannot\n * drift between them: the frontend single-node executor (`execute-node.ts`),\n * the orchestrator (`payload-builder.ts`), and the config-panel final-prompt\n * preview (`build-image-assemble-input.ts`).\n *\n * `readDirectionFields` is DERIVED FROM `DIRECTION_FIELDS`, never a hand list:\n * a dimension added to the registry is honored here by construction, so the\n * reader can never silently drop a key the wire schema and the renderer both\n * know about. Anything unrecognised is DROPPED, never thrown on — a malformed\n * blob must not fail a canvas run, and an unknown catalog ID already degrades\n * to `\"\"` inside each `get*PromptHint`, so this validates SHAPE only.\n *\n * BOUNDS MATCH THE WIRE SCHEMA where both exist, by SHARED CONSTANT:\n * `DIRECTION_ID_MAX_CHARS` and `DIRECTION_ARRAY_CEILING` are the same two\n * literals the `generate-image` route's `directionSchema` enforces, imported\n * from the registry rather than re-typed here — a body the route accepts and a\n * node the canvas re-runs must not disagree about which strings are ids.\n *\n * DELIBERATELY STRICTER THAN THE WIRE SCHEMA on `structured` values: the\n * route's `structuredPromptFieldsSchema` declares every field as a bare\n * `z.string().optional()` (unbounded), while `MAX_STRUCTURED_VALUE_CHARS` below\n * bounds them at 200. Do not \"fix\" that asymmetry by loosening HERE — this\n * reads a blob any client may have written years ago, and the values land\n * verbatim in `jobs.input_data.prompt`. Tightening the ROUTE instead would be a\n * new 400 on currently-accepted input, so a >200-char structured value stored\n * on a node is dropped on a canvas run while `POST /v1/generate-image` still\n * renders it. That is the one known divergence; it is bounded to a field the\n * canvas UI never writes that long.\n *\n * RETURNS `undefined`, NEVER `{}`: an empty object would still be a *defined*\n * `direction`, and the call sites' `...(x !== undefined ? { x } : {})` spread\n * would then hand `assembleImageInput` a defined-but-empty lever. Returning\n * `undefined` keeps that spread honest and the exact no-op branch taken.\n */\nimport {\n  DIRECTION_ARRAY_CEILING,\n  DIRECTION_FIELDS,\n  DIRECTION_ID_MAX_CHARS,\n  type DirectionFields,\n} from \"./direction-registry.js\"\nimport {\n  SUBJECT_ARRAY_CEILING,\n  SUBJECT_CUSTOM_AGE_KEY,\n  SUBJECT_ID_MAX_CHARS,\n  getRegisteredSubjectKeys,\n  type SubjectFields,\n} from \"./subject-registry.js\"\nimport type { StructuredPromptFields } from \"./prompt-builder-structured-fields.js\"\n\n/**\n * Read a node's stored cinematic-direction ids. Accepts a single id OR an array\n * on every key (multi-pick dimensions carry arrays; a single-pick key may\n * legitimately carry one).\n *\n * The SEMANTIC per-dimension cap stays the renderer's slice (`maxPicks`) — this\n * reader does not know a row's pick budget and must not guess it. But it DOES\n * bound cardinality at `DIRECTION_ARRAY_CEILING`, the same ceiling the wire\n * schema enforces: the value is untrusted persisted JSONB (a node blob is\n * validated only as `z.record(z.string(), z.unknown())` on write), and handing\n * an unbounded array to `renderDirectionHints` would put an `includes`-dedupe\n * scan in front of that slice. Keeping the FIRST `DIRECTION_ARRAY_CEILING`\n * survivors is what the wire door already does to the same input.\n *\n * Junk is filtered BEFORE the cap, so valid ids sitting behind malformed\n * entries survive rather than being crowded out by them.\n */\nexport function readDirectionFields(value: unknown): DirectionFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, string | string[]> = {}\n  for (const spec of DIRECTION_FIELDS) {\n    const v = src[spec.key]\n    if (typeof v === \"string\") {\n      if (v.length > 0 && v.length <= DIRECTION_ID_MAX_CHARS) out[spec.key] = v\n    } else if (Array.isArray(v)) {\n      const kept: string[] = []\n      for (const x of v) {\n        if (kept.length >= DIRECTION_ARRAY_CEILING) break\n        if (typeof x === \"string\" && x.length > 0 && x.length <= DIRECTION_ID_MAX_CHARS) {\n          kept.push(x)\n        }\n      }\n      if (kept.length > 0) out[spec.key] = kept\n    }\n  }\n  return Object.keys(out).length > 0 ? (out as DirectionFields) : undefined\n}\n\n// ── subject ──────────────────────────────────────────────────────────────────\n\n/**\n * Read a node's stored SUBJECT ids — the flat Person / Styling / prop bag the\n * `subject` channel carries. Same three contracts as `readDirectionFields`:\n * drop-never-throw, `undefined` never `{}`, and bounds shared with the wire\n * door by CONSTANT (`SUBJECT_ID_MAX_CHARS` / `SUBJECT_ARRAY_CEILING`, which are\n * defined AS the direction constants) so a body the route accepts and the same\n * node re-run from the canvas cannot disagree about which strings are ids.\n *\n * DERIVED from `getRegisteredSubjectKeys()`, never a hand-authored field list —\n * that is the whole lesson of `readStructuredFields` below, whose hand table is\n * only viable because `StructuredPromptFields` is a small hand-authored type.\n * The subject vocabulary is ~54 catalog-derived fields PLUS deployment-registered\n * pack dimensions unknown at compile time, so it is read from the registry at\n * call time. Iterating the KEY SET (never `Object.keys(value)`) is also what\n * keeps an adversarial blob's key count off the hot path.\n *\n * The SEMANTIC per-dimension cap stays the renderer's job\n * (`normalizeSubjectFields`), exactly as `maxPicks` does for direction: this\n * reader bounds cardinality only. `customAge` is the one number on the wire and\n * is passed through finite-only — the renderer clamps it.\n */\nexport function readSubjectFields(value: unknown): SubjectFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, string | string[] | number> = {}\n  for (const key of getRegisteredSubjectKeys()) {\n    const v = src[key]\n    if (key === SUBJECT_CUSTOM_AGE_KEY) {\n      if (typeof v === \"number\" && Number.isFinite(v)) out[key] = v\n      continue\n    }\n    if (typeof v === \"string\") {\n      if (v.length > 0 && v.length <= SUBJECT_ID_MAX_CHARS) out[key] = v\n    } else if (Array.isArray(v)) {\n      // Junk is filtered BEFORE the cap, so valid ids sitting behind malformed\n      // entries survive rather than being crowded out by them.\n      const kept: string[] = []\n      for (const x of v) {\n        if (kept.length >= SUBJECT_ARRAY_CEILING) break\n        if (typeof x === \"string\" && x.length > 0 && x.length <= SUBJECT_ID_MAX_CHARS) {\n          kept.push(x)\n        }\n      }\n      if (kept.length > 0) out[key] = kept\n    }\n  }\n  return Object.keys(out).length > 0 ? (out as SubjectFields) : undefined\n}\n\n// ── structured ───────────────────────────────────────────────────────────────\n\ntype FieldKind = \"string\" | \"number\" | \"gender\"\nconst GENDERS = [\"man\", \"woman\", \"child\", \"non-binary\"] as const\nconst MAX_STRUCTURED_VALUE_CHARS = 200\n\ntype Group = Exclude<keyof StructuredPromptFields, \"mood\">\ntype GroupFields<K extends Group> = Record<keyof NonNullable<StructuredPromptFields[K]>, FieldKind>\n\n/**\n * A FIELD-BY-FIELD table (not a registry walk) on purpose:\n * `StructuredPromptFields` is a small HAND-AUTHORED type, not catalog-derived,\n * and the table is what blocks `person: { age: \"drop table\" }` from rendering\n * verbatim into `jobs.input_data.prompt` — `renderStructuredFields` never\n * throws on junk, but it does render it. Totality is enforced by the\n * `GroupFields<K>` / `{ [K in Group]: … }` mapped types: a new field or group\n * on the published type fails to typecheck here.\n */\nconst PERSON_FIELDS: GroupFields<\"person\"> = {\n  age: \"number\",\n  gender: \"gender\",\n  hair: \"string\",\n  eyes: \"string\",\n  expression: \"string\",\n  profession: \"string\",\n  warriorType: \"string\",\n}\nconst STYLING_FIELDS: GroupFields<\"styling\"> = {\n  mood: \"string\",\n  lighting: \"string\",\n  aesthetic: \"string\",\n  colorLook: \"string\",\n}\nconst SETTING_FIELDS: GroupFields<\"setting\"> = {\n  era: \"string\",\n  atmosphere: \"string\",\n  backdrop: \"string\",\n}\nconst CAMERA_FIELDS: GroupFields<\"camera\"> = {\n  framing: \"string\",\n  motion: \"string\",\n  format: \"string\",\n}\nconst LENS_FIELDS: GroupFields<\"lens\"> = { focalLength: \"string\", aperture: \"string\" }\n\nconst STRUCTURED_GROUPS: { [K in Group]: GroupFields<K> } = {\n  person: PERSON_FIELDS,\n  styling: STYLING_FIELDS,\n  setting: SETTING_FIELDS,\n  camera: CAMERA_FIELDS,\n  lens: LENS_FIELDS,\n}\n\nfunction readField(v: unknown, kind: FieldKind): string | number | undefined {\n  if (kind === \"number\") return typeof v === \"number\" && Number.isFinite(v) ? v : undefined\n  if (typeof v !== \"string\" || v.length === 0 || v.length > MAX_STRUCTURED_VALUE_CHARS) {\n    return undefined\n  }\n  if (kind === \"gender\") return (GENDERS as readonly string[]).includes(v) ? v : undefined\n  return v\n}\n\n/** Read a node's stored Path-1 structured prompt fields. Same drop-never-throw\n *  and `undefined`-never-`{}` contract as `readDirectionFields`. */\nexport function readStructuredFields(value: unknown): StructuredPromptFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, unknown> = {}\n  for (const group of Object.keys(STRUCTURED_GROUPS) as Group[]) {\n    const raw = src[group]\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) continue\n    const rawRec = raw as Record<string, unknown>\n    const kept: Record<string, unknown> = {}\n    for (const [field, kind] of Object.entries(\n      STRUCTURED_GROUPS[group] as Record<string, FieldKind>,\n    )) {\n      const v = readField(rawRec[field], kind)\n      if (v !== undefined) kept[field] = v\n    }\n    if (Object.keys(kept).length > 0) out[group] = kept\n  }\n  const mood = readField(src.mood, \"string\")\n  if (mood !== undefined) out.mood = mood\n  return Object.keys(out).length > 0 ? (out as StructuredPromptFields) : undefined\n}\n"]}