@nodaro/shared 1.22.0 → 1.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "1.22.0",
+  "version": "1.23.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__/llm-models.test.ts

@@ -678,6 +678,25 @@ describe("advanced mode", () => {
     }
   })
 
+  it("no advanced-capable model declares xhigh/max — the UI copy depends on it", () => {
+    // `EFFORT_LABELS` in reasoning-effort-select.tsx labels xhigh/max "may bill
+    // one tier up" and its comment explains that the effort bump and the
+    // advanced bump can never both apply, because Advanced is Gemini-only and
+    // no Gemini model reaches xhigh/max. That was a note asking a future reader
+    // to remember; this is the check that fails instead.
+    //
+    // If this ever goes red, the two bumps CAN stack: reword the labels to say
+    // so and revisit whether a double bump is the price we want.
+    for (const m of LLM_MODELS) {
+      if (!supportsAdvancedMode(m.id)) continue
+      const levels = [...(m.reasoningEfforts ?? []), ...(m.directReasoningEfforts ?? [])]
+      expect(levels, `${m.id} can run advanced AND declares a tier-bumping effort`)
+        .not.toEqual(expect.arrayContaining(["xhigh"]))
+      expect(levels, `${m.id} can run advanced AND declares a tier-bumping effort`)
+        .not.toEqual(expect.arrayContaining(["max"]))
+    }
+  })
+
   it("never bumps past premium", () => {
     expect(buildLlmCreditIdentifier("llm-chat", "gemini-3.1-pro", "max", true)).toBe("llm-chat:premium")
   })

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

@@ -13,7 +13,9 @@ import {
   VIDEO_ANALYSIS_BUCKET_CREDITS,
   VIDEO_ANALYSIS_DURATION_BUCKETS,
   VIDEO_ANALYSIS_MAX_DURATION_SEC,
+  buildVideoAnalysisCreditId,
 } from "../video-analysis-pricing.js"
+import { DEFAULT_VIDEO_ANALYSIS_MODEL } from "../llm-models.js"
 
 /** Every `video-analysis:*` pricing row declared anywhere in the catalog. */
 const catalogRows = Object.values(MODEL_CATALOG)
@@ -61,3 +63,40 @@ describe("model catalog video-analysis pricing", () => {
     }
   })
 })
+
+/**
+ * The BARE `video-analysis` node-type id — the one every colon-scoped guard misses.
+ *
+ * `getModelIdentifier` (frontend) has no video-analysis branch, so it falls through
+ * to `return nodeType` and the run-credits estimate resolves this exact id. It was
+ * seeded at 3 credits in migration 247 with the comment "= flash 600s" and then
+ * skipped by FIVE consecutive repricings (248, 259, 273, 275, 276), every one of
+ * which matched only `video-analysis:` prefixes — including this test file's own
+ * `catalogRows` filter above. A real run reserves 21-200, so the pre-run balance
+ * check was quoting 3 for a run it would then refuse.
+ *
+ * The value is the MAXIMUM of the table, not the default tier at the ceiling
+ * bucket: this test's first version pinned the latter and failed immediately,
+ * because the default (pro) tops out at 120 while `mixed` reaches 200. Reached only
+ * when BOTH model and duration are unknown, so it has to bound every row.
+ */
+describe("bare video-analysis node-type credit id", () => {
+  it("bounds EVERY bucketed row — an unknown-duration estimate must never UNDER-quote", () => {
+    const ceiling = Math.max(...Object.values(VIDEO_ANALYSIS_BUCKET_CREDITS))
+    for (const [id, credits] of Object.entries(VIDEO_ANALYSIS_BUCKET_CREDITS)) {
+      expect(credits, `${id} exceeds the bare-id ceiling ${ceiling}`).toBeLessThanOrEqual(ceiling)
+    }
+    // The migration writes this number; keep them in lockstep (277 wrote 200, 278
+    // writes 739 after the measured reprice).
+    expect(ceiling).toBe(739)
+  })
+
+  it("the default tier at the ceiling bucket is NOT a safe fallback — mixed costs more", () => {
+    // Pins the reason the bare id is the table max rather than the intuitive
+    // "default model, longest video" value, so nobody re-derives it wrongly.
+    const defaultAtCeiling = VIDEO_ANALYSIS_BUCKET_CREDITS[
+      buildVideoAnalysisCreditId(DEFAULT_VIDEO_ANALYSIS_MODEL, VIDEO_ANALYSIS_MAX_DURATION_SEC)
+    ]!
+    expect(defaultAtCeiling).toBeLessThan(Math.max(...Object.values(VIDEO_ANALYSIS_BUCKET_CREDITS)))
+  })
+})

package/src/index.ts

@@ -279,6 +279,9 @@ export {
   resolveLlmCreditId,
   supportsAdvancedMode,
   availableReasoningEfforts,
+  LLM_ROUTE_DEFAULTS,
+  llmRouteDefaults,
+  type LlmRouteDefaults,
   ADVANCED_MODE_UNAVAILABLE_REASON,
   motionGraphicsFeature,
   effectiveReasoningEffort,

package/src/llm-models.ts

@@ -550,6 +550,49 @@ export function effectiveReasoningEffort(
  * premium stays premium). `high` is the Claude-family server default and
  * never bumps.
  */
+
+/**
+ * The sampling defaults each LLM feature's route sends when Advanced mode is
+ * OFF — and therefore the values its Advanced panel must seed the sliders with.
+ *
+ * SINGLE SOURCE because the two used to disagree: the routes hardcoded their
+ * own literals while the toggle fell back to 0.7/2048, so the panel displayed
+ * a temperature the run never used, and one arrow-key press on 3D Title's Max
+ * Tokens silently cut its budget from 3072 to 2048 on a node that emits
+ * structured JSON.
+ *
+ * `structuredOutput` marks the features whose prompt asks the model for JSON —
+ * a high temperature measurably degrades schema adherence there, so the panel
+ * warns. Absent `temperature` means the route sends none (vendor default).
+ */
+export interface LlmRouteDefaults {
+  temperature?: number
+  maxTokens?: number
+  structuredOutput?: true
+}
+
+export const LLM_ROUTE_DEFAULTS: Record<string, LlmRouteDefaults> = {
+  "llm-chat":                { temperature: 0.7,  maxTokens: 8192 },
+  "ai-writer":               { temperature: 0.7,  maxTokens: 8192 },
+  "prompt-helper":           { temperature: 0.7,  maxTokens: 8192, structuredOutput: true },
+  "generate-script":         { maxTokens: 16384, structuredOutput: true },
+  "qa-check":                { maxTokens: 1024,  structuredOutput: true },
+  "image-critic":            { maxTokens: 1024,  structuredOutput: true },
+  "image-to-text":           { maxTokens: 1024 },
+  "describe-to-picker":      { structuredOutput: true },
+  "scene-graph-ai":          { temperature: 0.3,  maxTokens: 4096, structuredOutput: true },
+  "after-effects":           { temperature: 0.3,  maxTokens: 2048, structuredOutput: true },
+  "lottie-overlay":          { temperature: 0.3,  maxTokens: 2048, structuredOutput: true },
+  "motion-graphics":         { temperature: 0.3,  maxTokens: 2048, structuredOutput: true },
+  "motion-graphics-lottie":  { temperature: 0.3,  maxTokens: 8192, structuredOutput: true },
+  "3d-title":                { temperature: 0.4,  maxTokens: 3072, structuredOutput: true },
+}
+
+/** Route defaults for a feature; `{}` for an unknown one. */
+export function llmRouteDefaults(feature: string | undefined): LlmRouteDefaults {
+  return (feature && LLM_ROUTE_DEFAULTS[feature]) || {}
+}
+
 /** One step up the economy → standard → premium ladder. Premium is the ceiling. */
 function bumpTier(tier: LlmTier): LlmTier {
   if (tier === "economy") return "standard"

package/src/model-catalog.ts

@@ -1815,11 +1815,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: 30, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:gemini-3-flash:60s", credits: 6 },
-      { identifier: "video-analysis:gemini-3-flash:180s", credits: 7 },
-      { identifier: "video-analysis:gemini-3-flash:360s", credits: 18 },
-      { identifier: "video-analysis:gemini-3-flash:600s", credits: 30, note: "10-min ceiling" },
+      { identifier: "video-analysis:gemini-3-flash", credits: 112, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3-flash:60s", credits: 21 },
+      { identifier: "video-analysis:gemini-3-flash:180s", credits: 24 },
+      { identifier: "video-analysis:gemini-3-flash:360s", credits: 68 },
+      { identifier: "video-analysis:gemini-3-flash:600s", credits: 112, note: "10-min ceiling" },
     ],
   },
   "gemini-3.6-flash-video-analysis": {
@@ -1832,11 +1832,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: 81, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:gemini-3.6-flash:60s", credits: 14 },
-      { identifier: "video-analysis:gemini-3.6-flash:180s", credits: 19 },
-      { identifier: "video-analysis:gemini-3.6-flash:360s", credits: 49 },
-      { identifier: "video-analysis:gemini-3.6-flash:600s", credits: 81, note: "10-min ceiling" },
+      { identifier: "video-analysis:gemini-3.6-flash", credits: 291, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3.6-flash:60s", credits: 54 },
+      { identifier: "video-analysis:gemini-3.6-flash:180s", credits: 63 },
+      { identifier: "video-analysis:gemini-3.6-flash:360s", credits: 175 },
+      { identifier: "video-analysis:gemini-3.6-flash:600s", credits: 291, note: "10-min ceiling" },
     ],
   },
   "gemini-3.1-pro-video-analysis": {
@@ -1849,11 +1849,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: 120, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:gemini-3.1-pro:60s", credits: 21 },
-      { identifier: "video-analysis:gemini-3.1-pro:180s", credits: 27 },
-      { identifier: "video-analysis:gemini-3.1-pro:360s", credits: 72 },
-      { identifier: "video-analysis:gemini-3.1-pro:600s", credits: 120, note: "10-min ceiling" },
+      { identifier: "video-analysis:gemini-3.1-pro", credits: 448, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:gemini-3.1-pro:60s", credits: 84 },
+      { identifier: "video-analysis:gemini-3.1-pro:180s", credits: 96 },
+      { identifier: "video-analysis:gemini-3.1-pro:360s", credits: 269 },
+      { identifier: "video-analysis:gemini-3.1-pro:600s", credits: 448, note: "10-min ceiling" },
     ],
   },
   // Both mixed tiers are variants of the same advanced multi-engine analysis
@@ -1869,11 +1869,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: 200, note: "10-min ceiling (no duration given)" },
-      { identifier: "video-analysis:mixed:60s", credits: 34 },
-      { identifier: "video-analysis:mixed:180s", credits: 46 },
-      { identifier: "video-analysis:mixed:360s", credits: 120 },
-      { identifier: "video-analysis:mixed:600s", credits: 200, note: "10-min ceiling" },
+      { identifier: "video-analysis:mixed", credits: 739, note: "10-min ceiling (no duration given)" },
+      { identifier: "video-analysis:mixed:60s", credits: 137 },
+      { identifier: "video-analysis:mixed:180s", credits: 158 },
+      { identifier: "video-analysis:mixed:360s", credits: 443 },
+      { identifier: "video-analysis:mixed:600s", credits: 739, note: "10-min ceiling" },
     ],
   },
 }

package/src/video-analysis-pricing.ts

@@ -50,27 +50,27 @@ export const VIDEO_ANALYSIS_WINDOW = { LEN: WINDOW_LEN, STRIDE: WINDOW_STRIDE, O
  */
 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": 6,
-  "video-analysis:gemini-3-flash:180s": 7,
-  "video-analysis:gemini-3-flash:360s": 18,
-  "video-analysis:gemini-3-flash:600s": 30,
+  "video-analysis:gemini-3-flash:60s": 21,
+  "video-analysis:gemini-3-flash:180s": 24,
+  "video-analysis:gemini-3-flash:360s": 68,
+  "video-analysis:gemini-3-flash:600s": 112,
   // 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": 14,
-  "video-analysis:gemini-3.6-flash:180s": 19,
-  "video-analysis:gemini-3.6-flash:360s": 49,
-  "video-analysis:gemini-3.6-flash:600s": 81,
-  "video-analysis:gemini-3.1-pro:60s": 21,
-  "video-analysis:gemini-3.1-pro:180s": 27,
-  "video-analysis:gemini-3.1-pro:360s": 72,
-  "video-analysis:gemini-3.1-pro:600s": 120,
+  "video-analysis:gemini-3.6-flash:60s": 54,
+  "video-analysis:gemini-3.6-flash:180s": 63,
+  "video-analysis:gemini-3.6-flash:360s": 175,
+  "video-analysis:gemini-3.6-flash:600s": 291,
+  "video-analysis:gemini-3.1-pro:60s": 84,
+  "video-analysis:gemini-3.1-pro:180s": 96,
+  "video-analysis:gemini-3.1-pro:360s": 269,
+  "video-analysis:gemini-3.1-pro:600s": 448,
   // 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": 34,
-  "video-analysis:mixed:180s": 46,
-  "video-analysis:mixed:360s": 120,
-  "video-analysis:mixed:600s": 200,
+  "video-analysis:mixed:60s": 137,
+  "video-analysis:mixed:180s": 158,
+  "video-analysis:mixed:360s": 443,
+  "video-analysis:mixed:600s": 739,
 }
 
 /**