@nodaro/shared 2.12.1 → 2.13.0

package/src/prompt-affixes.ts

@@ -0,0 +1,43 @@
+/**
+ * Prompt pre/post text ("affixes") — the PUBLIC node-data contract.
+ *
+ * Every AI prompt node may carry two optional strings that are wrapped around
+ * its run-time prompt: `promptPrefix` goes before, `promptSuffix` after. Both
+ * support `{Node Label}` references and plain-text snippets exactly like the
+ * main prompt. They are settings (edited in the node's config panel, captured
+ * by presets, settable through workflow JSON / `inputOverrides`), never shown
+ * on the node face or to published-app end users.
+ *
+ * Only the KEYS + TYPE live here (what the SDK/API contract needs). The wrap
+ * behaviour (`applyPromptAffixes`) lives in `@nodaro/prompts` next to
+ * `resolvePrompt` — see the spec's IP-placement note.
+ */
+export const PROMPT_PREFIX_KEY = "promptPrefix" as const
+export const PROMPT_SUFFIX_KEY = "promptSuffix" as const
+
+export interface PromptAffixFields {
+  /** Text placed BEFORE the node's prompt at run time. Supports {Node Label} refs. */
+  readonly promptPrefix?: string
+  /** Text placed AFTER the node's prompt at run time. Supports {Node Label} refs. */
+  readonly promptSuffix?: string
+}
+
+/** The affix pair read off node data (blank / non-string values are omitted). */
+export interface PromptAffixes {
+  readonly prefix?: string
+  readonly suffix?: string
+}
+
+function nonBlank(v: unknown): string | undefined {
+  return typeof v === "string" && v.trim().length > 0 ? v : undefined
+}
+
+/** Read `{ prefix, suffix }` off a node's `data`. Never throws; unknown shapes → `{}`. */
+export function readPromptAffixes(data: Record<string, unknown>): PromptAffixes {
+  const prefix = nonBlank(data[PROMPT_PREFIX_KEY])
+  const suffix = nonBlank(data[PROMPT_SUFFIX_KEY])
+  return {
+    ...(prefix !== undefined ? { prefix } : {}),
+    ...(suffix !== undefined ? { suffix } : {}),
+  }
+}

package/src/video-analysis-pricing.ts

@@ -86,39 +86,50 @@ export const VIDEO_ANALYSIS_WINDOW = { LEN: WINDOW_LEN, STRIDE: WINDOW_STRIDE, O
 //
 // Values are pasted verbatim from the plugin generator's output — never hand
 // computed. The plugin's cost test cross-checks every row, sentinels included.
+// REGENERATED 2026-08-28 — recast shot-craft Stage 1: the analyser's system
+// prompt grew (transition/on-screen-text doctrine + three required wire
+// fields), so the plugin's system-prompt token pin moved 8_203 → 8_482 and
+// 21 of 28 rows tick up by 1–4 credits (~0.1–0.3%). Output of the plugin's
+// `scripts/gen-va-buckets.mjs` on `feat/va-shot-craft`, pasted verbatim.
+//
+// REGENERATED 2026-08-29 — recast shot-craft Stage 1.3: the analyser's system
+// prompt grew again, moving the plugin's system-prompt token pin 8_482 → 8_706
+// (cloud-plugins 0.209.0). 12 of 20 analysis rows and 6 of 8 audit rows tick up
+// by 1–3 credits (~0.1–0.3%); the legacy `gemini-3-flash` family is unchanged.
+// Output of the plugin's `scripts/gen-va-buckets.mjs`, pasted verbatim.
 export const VIDEO_ANALYSIS_BUCKET_CREDITS: Record<string, number> = {
   // Legacy fast-tier model (pre-2026-07) — kept for stored raw-id configs.
   "video-analysis:gemini-3-flash:60s": 180,
   "video-analysis:gemini-3-flash:180s": 185,
-  "video-analysis:gemini-3-flash:360s": 514,
-  "video-analysis:gemini-3-flash:600s": 846,
+  "video-analysis:gemini-3-flash:360s": 515,
+  "video-analysis:gemini-3-flash:600s": 847,
   // Current fast tier — regenerated from the private formula for its backing
   // model; higher than the legacy fast schedule but still ≤ pro per bucket.
-  "video-analysis:gemini-3.6-flash:60s": 203,
+  "video-analysis:gemini-3.6-flash:60s": 204,
   "video-analysis:gemini-3.6-flash:180s": 218,
-  "video-analysis:gemini-3.6-flash:360s": 598,
-  "video-analysis:gemini-3.6-flash:600s": 986,
-  "video-analysis:gemini-3.1-pro:60s": 215,
-  "video-analysis:gemini-3.1-pro:180s": 231,
-  "video-analysis:gemini-3.1-pro:360s": 636,
-  "video-analysis:gemini-3.1-pro:600s": 1050,
+  "video-analysis:gemini-3.6-flash:360s": 600,
+  "video-analysis:gemini-3.6-flash:600s": 990,
+  "video-analysis:gemini-3.1-pro:60s": 216,
+  "video-analysis:gemini-3.1-pro:180s": 232,
+  "video-analysis:gemini-3.1-pro:360s": 639,
+  "video-analysis:gemini-3.1-pro:600s": 1053,
   // Mixed tiers (`mixed` + `mixed-fast`) share ONE credit family — they are
   // variants of the same engine plan (plan internals live in the private
   // analysis plugin). Admin-tunable via model_pricing like every other row.
-  "video-analysis:mixed:60s": 268,
-  "video-analysis:mixed:180s": 289,
-  "video-analysis:mixed:360s": 724,
-  "video-analysis:mixed:600s": 1169,
+  "video-analysis:mixed:60s": 269,
+  "video-analysis:mixed:180s": 290,
+  "video-analysis:mixed:360s": 727,
+  "video-analysis:mixed:600s": 1174,
   // SMART — the accuracy tier, and since the 2026-08-03 re-plan a multi-roll
   // plan like the others, always refined (`selectionMode` does not apply
   // here — smart always refines; it never offers a cheaper "choose" path).
   // Priced above the economy tiers because it genuinely costs more to run;
   // the only tier whose accuracy is validated against a hand-counted edit
   // list, re-validated at the current plan before this schedule shipped.
-  "video-analysis:smart:60s": 410,
-  "video-analysis:smart:180s": 500,
-  "video-analysis:smart:360s": 1259,
-  "video-analysis:smart:600s": 2064,
+  "video-analysis:smart:60s": 412,
+  "video-analysis:smart:180s": 502,
+  "video-analysis:smart:360s": 1264,
+  "video-analysis:smart:600s": 2071,
 }
 
 /**
@@ -188,14 +199,14 @@ export function videoAnalysisNumWindows(bucketSec: number): number {
  * never hand computed. The plugin's cost test cross-checks every row.
  */
 export const VIDEO_AUDIT_BUCKET_CREDITS: Record<string, number> = {
-  "video-audit:60s": 213,
-  "video-audit:180s": 289,
-  "video-audit:360s": 659,
-  "video-audit:600s": 1066,
-  "video-audit:auto:60s": 393,
-  "video-audit:auto:180s": 474,
-  "video-audit:auto:360s": 1173,
-  "video-audit:auto:600s": 1912,
+  "video-audit:60s": 214,
+  "video-audit:180s": 290,
+  "video-audit:360s": 661,
+  "video-audit:600s": 1070,
+  "video-audit:auto:60s": 394,
+  "video-audit:auto:180s": 475,
+  "video-audit:auto:360s": 1176,
+  "video-audit:auto:600s": 1917,
 }
 
 /**

package/src/video-analysis.ts

@@ -84,8 +84,20 @@ export type VideoAnalysisVisualEffect = (typeof VIDEO_ANALYSIS_VISUAL_EFFECTS)[n
  * `dissolve` (a cross-fade from one image to the other) is distinct from `fade`
  * (through black or white). Collapsing both onto `fade` — as this enum did — makes
  * a recreation render the wrong edit, and the two look nothing alike.
+ *
+ * ABSENT means NOTHING ASSERTED (since v2): the analyser emits a value only
+ * when it can see the device; an unknown or uncertain edit is left out so the
+ * video model chooses. `cut` is itself an assertion (an instant change between
+ * two clearly different shots), never a default.
  */
-export const VIDEO_ANALYSIS_TRANSITIONS = ["cut", "fade", "dissolve", "wipe", "whip"] as const
+export const VIDEO_ANALYSIS_TRANSITIONS = [
+  "cut", "fade", "dissolve", "wipe", "whip",
+  // v2 (2026-08-30, recast shot craft rev 1.5 Appendix F): the common edits a
+  // creator actually cuts with. `white-flash` / `digital-glitch` are spelled
+  // out because `flash` / `glitch` already name in-shot EFFECTS (the axis test
+  // below) — a device is the edit BETWEEN two shots, an effect is on one shot.
+  "zoom", "slide", "white-flash", "digital-glitch", "morph", "match", "jump",
+] as const
 export type VideoAnalysisTransition = (typeof VIDEO_ANALYSIS_TRANSITIONS)[number]
 
 /**