@nodaro/shared 2.12.2 → 2.14.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

@@ -97,39 +97,47 @@ export const VIDEO_ANALYSIS_WINDOW = { LEN: WINDOW_LEN, STRIDE: WINDOW_STRIDE, O
 // (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.
+//
+// REGENERATED 2026-08-30 — transition vocabulary v2: the analyser's doctrine now
+// DEFINES twelve named transition values (and says an absent transition asserts
+// nothing), which grew the analyser's system prompt once more — the plugin's
+// system-prompt token pin moved 8_706 → 9_082 (cloud-plugins 0.212.0). 15 of 20
+// analysis rows and 6 of 8 audit rows tick up by 1–5 credits (~0.1–0.6%); unlike
+// the 8_482 → 8_706 round, the legacy `gemini-3-flash` family moves too.
+// 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:60s": 181,
   "video-analysis:gemini-3-flash:180s": 185,
   "video-analysis:gemini-3-flash:360s": 515,
-  "video-analysis:gemini-3-flash:600s": 847,
+  "video-analysis:gemini-3-flash:600s": 848,
   // 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": 204,
-  "video-analysis:gemini-3.6-flash:180s": 218,
-  "video-analysis:gemini-3.6-flash:360s": 600,
-  "video-analysis:gemini-3.6-flash:600s": 990,
+  "video-analysis:gemini-3.6-flash:180s": 219,
+  "video-analysis:gemini-3.6-flash:360s": 602,
+  "video-analysis:gemini-3.6-flash:600s": 992,
   "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,
+  "video-analysis:gemini-3.1-pro:360s": 640,
+  "video-analysis:gemini-3.1-pro:600s": 1056,
   // 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": 269,
-  "video-analysis:mixed:180s": 290,
-  "video-analysis:mixed:360s": 727,
-  "video-analysis:mixed:600s": 1174,
+  "video-analysis:mixed:60s": 270,
+  "video-analysis:mixed:180s": 291,
+  "video-analysis:mixed:360s": 729,
+  "video-analysis:mixed:600s": 1177,
   // 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": 412,
-  "video-analysis:smart:180s": 502,
-  "video-analysis:smart:360s": 1264,
-  "video-analysis:smart:600s": 2071,
+  "video-analysis:smart:60s": 413,
+  "video-analysis:smart:180s": 503,
+  "video-analysis:smart:360s": 1267,
+  "video-analysis:smart:600s": 2076,
 }
 
 /**
@@ -199,14 +207,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": 214,
+  "video-audit:60s": 215,
   "video-audit:180s": 290,
-  "video-audit:360s": 661,
-  "video-audit:600s": 1070,
-  "video-audit:auto:60s": 394,
+  "video-audit:360s": 663,
+  "video-audit:600s": 1073,
+  "video-audit:auto:60s": 396,
   "video-audit:auto:180s": 475,
-  "video-audit:auto:360s": 1176,
-  "video-audit:auto:600s": 1917,
+  "video-audit:auto:360s": 1178,
+  "video-audit:auto:600s": 1921,
 }
 
 /**

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]
 
 /**