@nodaro/shared 2.8.0 → 2.10.0

package/src/video-analysis-pricing.ts

@@ -9,14 +9,12 @@
  * `buildVideoAnalysisCreditId` + `/v1/credits/model-cost`) all derive from
  * these.
  *
- * The measured-rate constants and the $-derived `videoAnalysisBucketCredits`
- * formula that GENERATE these numbers live PRIVATELY in the
- * `@nodaroai/cloud-plugins` package (`src/plugins/video-analysis/cost.ts`) —
- * never in this public repo. They were first moved out of this package
- * (published Apache-2.0 on npm) per the 2026-07-06 public-flip IP audit S5,
- * then out of the app repo entirely alongside the rest of the video-analysis
- * node. A cross-check test in that private package guards this table so the
- * public numbers can't silently drift from the formula.
+ * The rate constants and the formula that GENERATE these numbers live
+ * PRIVATELY in the `@nodaroai/cloud-plugins` package — never in this public
+ * repo. They were first moved out of this package (published Apache-2.0 on
+ * npm), then out of the app repo entirely alongside the rest of the
+ * video-analysis node. A cross-check test in that private package guards
+ * this table so the public numbers can't silently drift from the formula.
  *
  * `VIDEO_ANALYSIS_BUCKET_CREDITS` below is the precomputed OUTPUT of that
  * private formula for every (model × bucket) combination — a plain credit
@@ -24,9 +22,8 @@
  * `VIDEO_CLIP_CREDITS` uses in `film-pricing.ts`. It is what the frontend's
  * client-side cost preview (`estimateNodeCredits` in
  * workflow-editor/types.ts) reads instead of calling the formula directly.
- * The formula's own test in `@nodaroai/cloud-plugins`
- * (`src/plugins/video-analysis/__tests__/cost.test.ts`) cross-checks this table
- * against it and fails on drift. There is deliberately NO app-side formula to
+ * The formula's own test in `@nodaroai/cloud-plugins` cross-checks this
+ * table against it and fails on drift. There is deliberately NO app-side formula to
  * check against — it was moved private in 2026-07 and the old backend test
  * went with it.
  *
@@ -65,27 +62,20 @@ export const VIDEO_ANALYSIS_WINDOW = { LEN: WINDOW_LEN, STRIDE: WINDOW_STRIDE, O
 // not 110). The plugin's cost test now covers sentinels as well, so this class
 // of drift fails CI instead of shipping.
 // REGENERATED 2026-07-31 with the smart-tier re-base (formula inputs moved in
-// the plugin: sampling 24→6 fps after a 43-run measurement found 6 equal on
-// content and strictly better on cast stability; the system-prompt and
-// per-window output-token constants trued-up to directly measured values).
-// Net effect: smart drops 27–47% per bucket — the 24 fps token spend was also
-// partly paying for media tokens the provider clamped and never counted — and
-// the economy rows tick up 3–6% from the prompt-token true-up.
+// the plugin: sampling 24→6 fps, which proved equal on content and better on
+// cast stability; system-prompt and per-window output-token constants updated).
+// Net effect: smart drops 27–47% per bucket, and the economy rows tick up 3–6%.
 //
-// REGENERATED 2026-08-03 — V1 hybrid-smart reprice (task A3), from the
-// plugin's own generator (`scripts/gen-va-buckets.mjs`) at
-// nodaroai/nodaro-cloud-plugins commit eef077d (branch fix/va-cost-trueup).
-// This is the V1 true-up of task P6's provisional judge/refine/frame-judge
-// constants, re-derived from a 2026-08-03 staging measurement and approved by
-// Tal (the constants themselves, like the rest of the $-derived formula, stay
-// private in the plugin repo — never in this public package). `smart` is now
-// a HYBRID plan — one native 6fps skeleton pass plus 2 fast + 2 pro donor
-// rolls, always refined (`selectionMode` does not apply to `smart`; it always
-// refines) — and every multi-roll tier now carries its own explicit
-// judge/refine terms instead of an implicit share of a single-pass budget.
-// This is the full, honest reprice Tal approved, including the economy tiers
-// (fast 33->185 @180s ends a below-cost combine exposure that existed at the
-// old price). Net effect, per bucket (every row rises):
+// REGENERATED 2026-08-03 — V1 hybrid-smart reprice, from the plugin's own
+// generator. This is the V1 true-up of the earlier provisional
+// judge/refine/frame-judge constants (the constants themselves, like the rest
+// of the formula, stay private in the plugin repo — never in this public
+// package). `smart` is now a multi-roll plan that always refines its merged
+// result (`selectionMode` does not apply to it), and every multi-roll tier
+// now carries its own explicit judge/refine terms instead of an implicit
+// share of a single-pass budget.
+// The economy tiers rise too (fast 33->185 @180s).
+// Net effect, per bucket (every row rises):
 //
 //   gemini-3-flash    60s   24->180   180s   33->185   360s   86-> 514   600s  143-> 846
 //   gemini-3.6-flash  60s   65->203   180s   92->218   360s  237-> 598   600s  395-> 986
@@ -119,9 +109,8 @@ export const VIDEO_ANALYSIS_BUCKET_CREDITS: Record<string, number> = {
   "video-analysis:mixed:180s": 289,
   "video-analysis:mixed:360s": 724,
   "video-analysis:mixed:600s": 1169,
-  // SMART — the accuracy tier, and since the 2026-08-03 hybrid re-plan a
-  // multi-roll plan like the others: one native 6fps skeleton pass plus 2
-  // fast + 2 pro donor rolls, always refined (`selectionMode` does not apply
+  // 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
@@ -168,7 +157,7 @@ export function videoAnalysisNumWindows(bucketSec: number): number {
  * Precomputed credit cost for the `video-audit` node ("AI Audit") — the same
  * pattern as `VIDEO_ANALYSIS_BUCKET_CREDITS` above: the OUTPUT of the private
  * `videoAuditBucketCredits` formula in `@nodaroai/cloud-plugins`
- * (`src/plugins/video-analysis/cost.ts`), a plain lookup table never a
+ * (in the plugin repo), a plain lookup table never a
  * formula, cross-checked against that package's own cost test. Shares the
  * SAME duration-bucket ladder as video-analysis (`VIDEO_ANALYSIS_DURATION_BUCKETS`
  * / `pickVideoAnalysisBucket`) — the audit re-watches the same clip, so it
@@ -195,7 +184,7 @@ export function videoAnalysisNumWindows(bucketSec: number): number {
  * `buildVideoAnalysisCreditId`.
  *
  * Values pasted verbatim from the plugin generator's output
- * (`scripts/gen-va-buckets.mjs`) at `@nodaroai/cloud-plugins` v0.102.0 —
+ * (the plugin repo's bucket generator) —
  * never hand computed. The plugin's cost test cross-checks every row.
  */
 export const VIDEO_AUDIT_BUCKET_CREDITS: Record<string, number> = {

package/src/workflow-export.ts

@@ -74,6 +74,45 @@ export interface WorkflowExportLocation {
   styleLock?: boolean | null
 }
 
+/** A media URL referenced from a node's data, located by node + field path. */
+export interface WorkflowMediaRef {
+  nodeId: string
+  nodeLabel?: string
+  /** Dot/bracket path inside `node.data`, e.g. `imageUrl` or `referenceImageUrls[1]`. */
+  field: string
+  url: string
+}
+
+/**
+ * Export-time portability analysis (#866). A bundle exported from a private
+ * host carries media URLs only that host can serve (`http://localhost:3000/
+ * storage/…`, a LAN address, a `.internal` name); imported anywhere else, the
+ * nodes fail at Run time with an opaque provider fetch error. The exporter
+ * lists those URLs here so the person exporting is told BEFORE sharing, and
+ * an importer can explain what will not load. Absent when every media URL is
+ * publicly routable.
+ */
+export interface WorkflowPortability {
+  unreachableMedia: WorkflowMediaRef[]
+}
+
+/**
+ * What the importer did about the bundle's media (#866). Publicly reachable
+ * media that is not already on the importing instance's own storage is
+ * copied there (`rehosted`) so the workflow runs from local copies; media on
+ * a host the importer cannot reach is left as-is and listed (`unreachable`);
+ * anything declined for another reason (too large, not a media type, over
+ * the per-import cap, upload failed) is listed with the reason (`skipped`).
+ */
+export interface WorkflowImportReport {
+  rehosted: number
+  unreachable: WorkflowMediaRef[]
+  skipped: Array<WorkflowMediaRef & { reason: string }>
+  /** Anything else the importer should know, e.g. copies were made but the
+   *  workflow could not be updated to use them. */
+  notes?: string[]
+}
+
 export interface WorkflowExport {
   version: 1
   exportedAt: string
@@ -87,6 +126,8 @@ export interface WorkflowExport {
     creatures?: WorkflowExportCreature[]
     locations: WorkflowExportLocation[]
   }
+  /** Present only when the bundle references media another instance cannot fetch. */
+  portability?: WorkflowPortability
 }
 
 /**