@nodaro/shared 2.13.0 → 2.15.0

package/dist/index.d.cts

@@ -1724,6 +1724,13 @@ declare function collectAncestorRefs<N extends GenericNode, E extends GenericEdg
  *  the backend (which sees node data as `Record<string, unknown>`) can pass
  *  raw JSON through `expandExtraRefsToConnectedReferences`. */
 interface ExtraRefInput {
+    /**
+     * Stable id of this extra reference, when the row has one. What a
+     * `{ref:<id>}` token in the prompt names; passed through to the shared video
+     * resolver's slot map by both the canvas and the orchestrator. Absent → the
+     * row still numbers normally but cannot be addressed by id.
+     */
+    readonly id?: string;
     readonly url?: string;
     readonly description?: string;
     readonly characterSlug?: string;
@@ -9521,6 +9528,7 @@ declare const windowSceneSchema: z.ZodObject<{
         morph: "morph";
         jump: "jump";
     }>>;
+    transition: z.ZodOptional<z.ZodString>;
     audio: z.ZodArray<z.ZodObject<{
         mode: z.ZodEnum<{
             music: "music";
@@ -9643,6 +9651,7 @@ declare const windowAnalysisSchema: z.ZodObject<{
             morph: "morph";
             jump: "jump";
         }>>;
+        transition: z.ZodOptional<z.ZodString>;
         audio: z.ZodArray<z.ZodObject<{
             mode: z.ZodEnum<{
                 music: "music";
@@ -9731,6 +9740,7 @@ declare const analyzedSceneSchema: z.ZodObject<{
         morph: "morph";
         jump: "jump";
     }>>;
+    transition: z.ZodOptional<z.ZodString>;
     audio: z.ZodArray<z.ZodObject<{
         mode: z.ZodEnum<{
             music: "music";
@@ -9863,6 +9873,7 @@ declare const videoAnalysisResultSchema: z.ZodObject<{
             morph: "morph";
             jump: "jump";
         }>>;
+        transition: z.ZodOptional<z.ZodString>;
         audio: z.ZodArray<z.ZodObject<{
             mode: z.ZodEnum<{
                 music: "music";

package/dist/index.d.ts

@@ -1724,6 +1724,13 @@ declare function collectAncestorRefs<N extends GenericNode, E extends GenericEdg
  *  the backend (which sees node data as `Record<string, unknown>`) can pass
  *  raw JSON through `expandExtraRefsToConnectedReferences`. */
 interface ExtraRefInput {
+    /**
+     * Stable id of this extra reference, when the row has one. What a
+     * `{ref:<id>}` token in the prompt names; passed through to the shared video
+     * resolver's slot map by both the canvas and the orchestrator. Absent → the
+     * row still numbers normally but cannot be addressed by id.
+     */
+    readonly id?: string;
     readonly url?: string;
     readonly description?: string;
     readonly characterSlug?: string;
@@ -9521,6 +9528,7 @@ declare const windowSceneSchema: z.ZodObject<{
         morph: "morph";
         jump: "jump";
     }>>;
+    transition: z.ZodOptional<z.ZodString>;
     audio: z.ZodArray<z.ZodObject<{
         mode: z.ZodEnum<{
             music: "music";
@@ -9643,6 +9651,7 @@ declare const windowAnalysisSchema: z.ZodObject<{
             morph: "morph";
             jump: "jump";
         }>>;
+        transition: z.ZodOptional<z.ZodString>;
         audio: z.ZodArray<z.ZodObject<{
             mode: z.ZodEnum<{
                 music: "music";
@@ -9731,6 +9740,7 @@ declare const analyzedSceneSchema: z.ZodObject<{
         morph: "morph";
         jump: "jump";
     }>>;
+    transition: z.ZodOptional<z.ZodString>;
     audio: z.ZodArray<z.ZodObject<{
         mode: z.ZodEnum<{
             music: "music";
@@ -9863,6 +9873,7 @@ declare const videoAnalysisResultSchema: z.ZodObject<{
             morph: "morph";
             jump: "jump";
         }>>;
+        transition: z.ZodOptional<z.ZodString>;
         audio: z.ZodArray<z.ZodObject<{
             mode: z.ZodEnum<{
                 music: "music";

package/dist/index.js

@@ -1808,11 +1808,11 @@ var VIDEO_MODELS = {
     description: "Legacy fast-tier analysis model (pre-2026-07). Kept so stored raw-model configs keep running and keep pricing under their own identifier; new fast-tier runs use the current fast model.",
     useCases: ["video-analysis", "shot-list", "fast"],
     pricing: [
-      { identifier: "video-analysis:gemini-3-flash", credits: 847, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:gemini-3-flash:60s", credits: 180 },
+      { identifier: "video-analysis:gemini-3-flash", credits: 848, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3-flash:60s", credits: 181 },
       { identifier: "video-analysis:gemini-3-flash:180s", credits: 185 },
       { identifier: "video-analysis:gemini-3-flash:360s", credits: 515 },
-      { identifier: "video-analysis:gemini-3-flash:600s", credits: 847, note: "10-min ceiling" }
+      { identifier: "video-analysis:gemini-3-flash:600s", credits: 848, note: "10-min ceiling" }
     ]
   },
   "gemini-3.6-flash-video-analysis": {
@@ -1825,11 +1825,11 @@ var VIDEO_MODELS = {
     description: "Analyze a video into a structured shot list (scenes, camera, audio) \u2014 fast, economy tier. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "fast"],
     pricing: [
-      { identifier: "video-analysis:gemini-3.6-flash", credits: 990, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3.6-flash", credits: 992, note: "10-min ceiling (no duration given)" },
       { identifier: "video-analysis:gemini-3.6-flash:60s", credits: 204 },
-      { identifier: "video-analysis:gemini-3.6-flash:180s", credits: 218 },
-      { identifier: "video-analysis:gemini-3.6-flash:360s", credits: 600 },
-      { identifier: "video-analysis:gemini-3.6-flash:600s", credits: 990, note: "10-min ceiling" }
+      { identifier: "video-analysis:gemini-3.6-flash:180s", credits: 219 },
+      { identifier: "video-analysis:gemini-3.6-flash:360s", credits: 602 },
+      { identifier: "video-analysis:gemini-3.6-flash:600s", credits: 992, note: "10-min ceiling" }
     ]
   },
   "gemini-3.1-pro-video-analysis": {
@@ -1842,11 +1842,11 @@ var VIDEO_MODELS = {
     description: "Analyze a video into a structured shot list (scenes, camera, audio) \u2014 higher-fidelity, default tier. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "cinematic"],
     pricing: [
-      { identifier: "video-analysis:gemini-3.1-pro", credits: 1053, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3.1-pro", credits: 1056, note: "10-min ceiling (no duration given)" },
       { identifier: "video-analysis:gemini-3.1-pro:60s", credits: 216 },
       { identifier: "video-analysis:gemini-3.1-pro:180s", credits: 232 },
-      { identifier: "video-analysis:gemini-3.1-pro:360s", credits: 639 },
-      { identifier: "video-analysis:gemini-3.1-pro:600s", credits: 1053, note: "10-min ceiling" }
+      { identifier: "video-analysis:gemini-3.1-pro:360s", credits: 640 },
+      { identifier: "video-analysis:gemini-3.1-pro:600s", credits: 1056, note: "10-min ceiling" }
     ]
   },
   // Both mixed tiers are variants of the same advanced multi-engine analysis
@@ -1862,11 +1862,11 @@ var VIDEO_MODELS = {
     description: "Our most advanced analysis tier \u2014 multiple analysis engines combined into one result for maximum completeness and accuracy. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "premium", "most-complete"],
     pricing: [
-      { identifier: "video-analysis:mixed", credits: 1174, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:mixed:60s", credits: 269 },
-      { identifier: "video-analysis:mixed:180s", credits: 290 },
-      { identifier: "video-analysis:mixed:360s", credits: 727 },
-      { identifier: "video-analysis:mixed:600s", credits: 1174, note: "10-min ceiling" }
+      { identifier: "video-analysis:mixed", credits: 1177, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:mixed:60s", credits: 270 },
+      { identifier: "video-analysis:mixed:180s", credits: 291 },
+      { identifier: "video-analysis:mixed:360s", credits: 729 },
+      { identifier: "video-analysis:mixed:600s", credits: 1177, note: "10-min ceiling" }
     ]
   },
   // SMART — the accuracy tier. Since the 2026-08-03 hybrid re-plan it is a
@@ -1884,11 +1884,11 @@ var VIDEO_MODELS = {
     description: "Highest-accuracy analysis \u2014 a hybrid pass that blends a native skeleton read with several donor analysis rolls, then always refines the merged result to find shot boundaries and identify the cast by appearance. Best choice when the shot list will drive regeneration. Billed per duration bucket.",
     useCases: ["video-analysis", "shot-list", "premium", "most-accurate"],
     pricing: [
-      { identifier: "video-analysis:smart", credits: 2071, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:smart:60s", credits: 412 },
-      { identifier: "video-analysis:smart:180s", credits: 502 },
-      { identifier: "video-analysis:smart:360s", credits: 1264 },
-      { identifier: "video-analysis:smart:600s", credits: 2071, note: "10-min ceiling" }
+      { identifier: "video-analysis:smart", credits: 2076, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:smart:60s", credits: 413 },
+      { identifier: "video-analysis:smart:180s", credits: 503 },
+      { identifier: "video-analysis:smart:360s", credits: 1267 },
+      { identifier: "video-analysis:smart:600s", credits: 2076, note: "10-min ceiling" }
     ]
   },
   // ── AI Audit (`video-audit`) ── a SEPARATE node from video-analysis (own
@@ -1912,11 +1912,11 @@ var VIDEO_MODELS = {
     description: "Re-watches a clip against a wired analysis, applies video-verified corrections under guards, and returns a disclosed report of what changed. Billed per duration bucket.",
     useCases: ["video-audit", "qa", "shot-list", "verification"],
     pricing: [
-      { identifier: "video-audit", credits: 1070, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-audit:60s", credits: 214 },
+      { identifier: "video-audit", credits: 1073, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-audit:60s", credits: 215 },
       { identifier: "video-audit:180s", credits: 290 },
-      { identifier: "video-audit:360s", credits: 661 },
-      { identifier: "video-audit:600s", credits: 1070, note: "10-min ceiling" }
+      { identifier: "video-audit:360s", credits: 663 },
+      { identifier: "video-audit:600s", credits: 1073, note: "10-min ceiling" }
     ]
   },
   "video-audit-auto": {
@@ -1928,11 +1928,11 @@ var VIDEO_MODELS = {
     description: "Same video-verified audit as AI Audit, but auto-runs a fast analysis first when none is wired in, then applies corrections under guards and returns a disclosed report. Billed per duration bucket.",
     useCases: ["video-audit", "qa", "shot-list", "verification", "auto-analysis"],
     pricing: [
-      { identifier: "video-audit:auto", credits: 1917, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-audit:auto:60s", credits: 394 },
+      { identifier: "video-audit:auto", credits: 1921, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-audit:auto:60s", credits: 396 },
       { identifier: "video-audit:auto:180s", credits: 475 },
-      { identifier: "video-audit:auto:360s", credits: 1176 },
-      { identifier: "video-audit:auto:600s", credits: 1917, note: "10-min ceiling" }
+      { identifier: "video-audit:auto:360s", credits: 1178 },
+      { identifier: "video-audit:auto:600s", credits: 1921, note: "10-min ceiling" }
     ]
   }
 };
@@ -13215,6 +13215,15 @@ var windowSceneBase = z.object({
   /** Effects on this shot's PICTURE. Absent ⇒ a clean image. */
   effects: z.array(z.enum(VIDEO_ANALYSIS_VISUAL_EFFECTS)).optional(),
   transitionOut: z.enum(VIDEO_ANALYSIS_TRANSITIONS).optional(),
+  // Round 4 (2026-08-30, recast shot craft rev 1.5 Appendix F.8): the edit into
+  // the next scene in the analyser's OWN WORDS — a few words of what it saw
+  // ("fast blurred pan left", "fade to black", "zoom-blur warp into the tunnel")
+  // — or absent when the take continues through the change or no edit is seen
+  // (nothing asserted: the video model decides from story and refs). The closed
+  // `transitionOut` vocabulary above is LEGACY from here on: kept so stored
+  // blueprints still parse, never emitted again. Readers take
+  // `transition ?? transitionOut`.
+  transition: z.string().trim().min(1).max(120).optional(),
   // Array of concurrent layers (music + speech + sfx together); [] = silence.
   audio: z.array(audioLayerSchema),
   /** slotId → variationId for slots wearing a NON-default look in this scene
@@ -13398,37 +13407,37 @@ var WINDOW_OVERLAP = 5;
 var VIDEO_ANALYSIS_WINDOW = { LEN: WINDOW_LEN, STRIDE: WINDOW_STRIDE, OVERLAP: WINDOW_OVERLAP, SINGLE_MAX: 180 };
 var VIDEO_ANALYSIS_BUCKET_CREDITS = {
   // 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
 };
 function videoAnalysisCreditSegment(modelOrSentinel) {
   return modelOrSentinel === "mixed-fast" ? "mixed" : modelOrSentinel;
@@ -13449,14 +13458,14 @@ function videoAnalysisNumWindows(bucketSec) {
   return bucketSec <= VIDEO_ANALYSIS_WINDOW.SINGLE_MAX ? 1 : 1 + Math.ceil((bucketSec - WINDOW_LEN) / WINDOW_STRIDE);
 }
 var VIDEO_AUDIT_BUCKET_CREDITS = {
-  "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
 };
 function buildVideoAuditCreditId(args) {
   const { analysisProvided, durationSec } = args;