@nodaro/shared 2.13.0 → 2.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/__tests__/video-analysis-catalog-sync.test.ts

@@ -160,9 +160,11 @@ describe("bare video-analysis node-type credit id", () => {
     // trued up every tier's judge/refine terms), 355 wrote 2068: the
     // recast shot-craft Stage-1 doctrine (transitions + on-screen text, three
     // required wire fields) grew the analyser's system prompt, moving the
-    // plugin's token pin 8_203 -> 8_482, and 356 wrote 2071: Stage 1.3 grew
-    // that prompt again, moving the pin 8_482 -> 8_706.
-    expect(ceiling).toBe(2071)
+    // plugin's token pin 8_203 -> 8_482, 356 wrote 2071: Stage 1.3 grew
+    // that prompt again, moving the pin 8_482 -> 8_706, and 357 wrote 2076:
+    // the transition vocabulary v2 doctrine (twelve named values; absent =
+    // nothing asserted) grew it once more, moving the pin 8_706 -> 9_082.
+    expect(ceiling).toBe(2076)
   })
 
   it("the bare id still bounds the default tier at the ceiling bucket", () => {

package/src/__tests__/video-analysis-pricing.test.ts

@@ -178,12 +178,12 @@ describe("video-audit-pricing", () => {
   })
 
   it("videoAuditCreditsForBucket: table lookup by resolved bucket + family, snapping a raw duration onto the ladder", () => {
-    expect(videoAuditCreditsForBucket(60, false)).toBe(214)
-    expect(videoAuditCreditsForBucket(60, true)).toBe(394)
+    expect(videoAuditCreditsForBucket(60, false)).toBe(215)
+    expect(videoAuditCreditsForBucket(60, true)).toBe(396)
     expect(videoAuditCreditsForBucket(180, false)).toBe(290)
-    expect(videoAuditCreditsForBucket(360, false)).toBe(661)
-    expect(videoAuditCreditsForBucket(600, false)).toBe(1070)
-    expect(videoAuditCreditsForBucket(600, true)).toBe(1917)
+    expect(videoAuditCreditsForBucket(360, false)).toBe(663)
+    expect(videoAuditCreditsForBucket(600, false)).toBe(1073)
+    expect(videoAuditCreditsForBucket(600, true)).toBe(1921)
     // Not just exact ladder values — a raw duration snaps up to its bucket.
     expect(videoAuditCreditsForBucket(70, false)).toBe(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:180s"])
     expect(videoAuditCreditsForBucket(9999, true)).toBe(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:auto:600s"])
@@ -224,8 +224,8 @@ describe("video-audit-pricing", () => {
     // 600s bucket here, same convention as VIDEO_ANALYSIS_BUCKET_CREDITS).
     expect(Object.keys(VIDEO_AUDIT_BUCKET_CREDITS)).toHaveLength(8)
     // Bare-id values quoted in the task/catalog must equal each family's 600s ceiling.
-    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:600s"]).toBe(1070)
-    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:auto:600s"]).toBe(1917)
+    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:600s"]).toBe(1073)
+    expect(VIDEO_AUDIT_BUCKET_CREDITS["video-audit:auto:600s"]).toBe(1921)
   })
 
   it("auto family = base family + the gemini-3-flash (legacy fast tier) row at the same bucket, exactly — single-source, never hand-added", () => {

package/src/extra-refs.ts

@@ -38,6 +38,13 @@ import type { ConnectedReference } from "./types.js"
  *  the backend (which sees node data as `Record<string, unknown>`) can pass
  *  raw JSON through `expandExtraRefsToConnectedReferences`. */
 export 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

package/src/model-catalog.ts

@@ -1971,11 +1971,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     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": {
@@ -1988,11 +1988,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Analyze a video into a structured shot list (scenes, camera, audio) — 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": {
@@ -2005,11 +2005,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Analyze a video into a structured shot list (scenes, camera, audio) — 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
@@ -2025,11 +2025,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Our most advanced analysis tier — 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
@@ -2047,11 +2047,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     description: "Highest-accuracy analysis — 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
@@ -2075,11 +2075,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     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": {
@@ -2091,11 +2091,11 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
     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" },
     ],
   },
 }

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,
 }
 
 /**