@nodaro/shared 2.2.1 → 2.5.0

package/src/model-constants.ts

@@ -605,8 +605,13 @@ export const IMAGE_I2I_PROVIDERS = [
   "kontext-multi",
   // BFL Flux 2 Pro — runs through Replicate with safety_tolerance=5 (max for Pro)
   "flux-2-pro",
+  // BFL FLUX Fill Pro — dedicated masked inpainting via Replicate (white = edit area)
+  "flux-fill",
   // BFL Flux 2 Max — runs through Replicate with safety_tolerance=5, up to 8 refs
   "flux-2-max",
+  // BFL FLUX Fill Pro — dedicated inpainting via Replicate (image + mask + prompt,
+  // white = edit area). Second mask-capable i2i provider alongside ideogram-edit.
+  "flux-fill",
 ] as const
 
 /** Image editing providers (upscale, remove bg, etc.) */
@@ -1039,7 +1044,7 @@ export type VoiceDesignModel = typeof VOICE_DESIGN_MODELS[number]
 export const DEFAULT_VOICE_DESIGN_MODEL: VoiceDesignModel = "eleven_ttv_v3"
 
 /** I2I providers that support mask-based inpainting */
-export const I2I_MASK_SUPPORT = new Set(["ideogram-edit"])
+export const I2I_MASK_SUPPORT = new Set(["ideogram-edit", "flux-fill"])
 
 /**
  * Mask edit tier per image-gen provider (single source of truth for inpaint).

package/src/normalize-node-params.ts

@@ -0,0 +1,126 @@
+/**
+ * Workflow-node parameter normalization.
+ *
+ * The config panels already prevent an impossible provider/parameter pair from
+ * being *selected*: their dropdowns are provider-aware and a fail-safe effect
+ * snaps stale values when the provider changes. But both of those are React
+ * effects — they only run when that specific node's panel or hover strip is
+ * mounted. A node written straight into workflow JSON by a non-UI author (an
+ * agent, an import, a template) is never seen by either, so its invalid pair
+ * survives all the way to the provider call.
+ *
+ * That is the 2026-08-09 incident: one `generate-image` node carrying
+ * `gpt-image` + `16:9` (GPT Image 1.5 renders 1:1 / 3:2 / 2:3 only) reached KIE,
+ * got rejected, and aborted a run whose five sibling nodes had already produced
+ * — and billed for — their images.
+ *
+ * This module is the write-boundary guard: it heals the node instead of
+ * rejecting it, so the user sees a valid value on the canvas rather than a
+ * failed run. It reads exclusively from `MODEL_CATALOG`, so a model added later
+ * is covered without touching this file.
+ */
+
+import { normalizeModelInput, type ModelInputAdjustment } from "./model-catalog.js"
+
+/**
+ * Node types whose `data` carries catalog-governed model parameters under the
+ * shape this module understands (`provider` + aspectRatio/resolution/quality).
+ *
+ * IMAGE ONLY, deliberately. The video nodes route several of these fields
+ * through mode-dependent defaults (`"adaptive"` for Seedance/Hailuo, duration
+ * composites tied to pricing) that this flat normalizer would flatten wrongly;
+ * they get their own pass once those defaults are catalog-derived too.
+ */
+export const MODEL_PARAM_NODE_TYPES: ReadonlySet<string> = new Set([
+  "generate-image",
+  "image-to-image",
+])
+
+export interface NodeParamAdjustment extends ModelInputAdjustment {
+  nodeId: string
+  provider: string
+}
+
+export interface NormalizedNodes<T> {
+  nodes: T[]
+  /** Empty when nothing needed correcting. */
+  adjustments: NodeParamAdjustment[]
+}
+
+interface NodeLike {
+  id?: unknown
+  type?: unknown
+  data?: unknown
+}
+
+/**
+ * Return `nodes` with every catalog-governed image parameter coerced into a
+ * combination its provider actually accepts, plus the list of what changed.
+ *
+ * Immutable: nodes that need no correction are returned by reference, and a
+ * corrected node is a fresh object (never a mutation of the caller's input).
+ *
+ * Multi-provider nodes (`data.providers` holding 2+ entries) are SKIPPED: the
+ * valid set there is the intersection across every selected provider, and when
+ * a stored value falls outside it there is no single defensible replacement —
+ * picking one provider's default would silently misconfigure the others. Those
+ * nodes are still guarded interactively by the panel's intersection dropdown.
+ */
+export function normalizeNodeModelParams<T extends NodeLike>(
+  nodes: readonly T[],
+): NormalizedNodes<T> {
+  const adjustments: NodeParamAdjustment[] = []
+  const out = nodes.map((node) => {
+    const type = typeof node.type === "string" ? node.type : ""
+    if (!MODEL_PARAM_NODE_TYPES.has(type)) return node
+
+    const data = node.data
+    if (!data || typeof data !== "object" || Array.isArray(data)) return node
+    const d = data as Record<string, unknown>
+
+    const multi = Array.isArray(d.providers) ? (d.providers as unknown[]) : []
+    if (multi.length > 1) return node
+
+    const provider =
+      typeof d.provider === "string"
+        ? d.provider
+        : typeof multi[0] === "string"
+          ? (multi[0] as string)
+          : undefined
+    if (!provider) return node
+
+    const normalized = normalizeModelInput(provider, {
+      aspectRatio: typeof d.aspectRatio === "string" ? d.aspectRatio : undefined,
+      resolution: typeof d.resolution === "string" ? d.resolution : undefined,
+      quality: typeof d.quality === "string" ? d.quality : undefined,
+    })
+    if (normalized.adjustments.length === 0) return node
+
+    const nodeId = typeof node.id === "string" ? node.id : "(unknown node)"
+    for (const adj of normalized.adjustments) {
+      adjustments.push({ ...adj, nodeId, provider })
+    }
+
+    // Only the three governed keys are rewritten; everything else on the node
+    // is passed through untouched. A dropped lever is written as `undefined`
+    // rather than deleted so the shape stays stable for downstream readers.
+    return {
+      ...node,
+      data: {
+        ...d,
+        aspectRatio: normalized.aspectRatio,
+        resolution: normalized.resolution,
+        quality: normalized.quality,
+      },
+    }
+  })
+
+  return { nodes: out, adjustments }
+}
+
+/** One-line-per-change summary, for surfacing back to an agent or a log. */
+export function describeNodeAdjustments(adjustments: readonly NodeParamAdjustment[]): string[] {
+  return adjustments.map(
+    (a) => `${a.nodeId} (${a.provider}): ${a.field} "${a.from}" → ${a.to === undefined ? "removed" : `"${a.to}"`} — ${a.reason}`,
+  )
+}

package/src/pipeline-defaults.ts

@@ -65,6 +65,7 @@ export function validateModeActivation(
 // Tier → max parallel pipelines (Architecture §5.4)
 export const TIER_PIPELINE_PARALLELISM: Record<string, number> = {
   free: 0,
+  payg: 1, // derived tier — pipeline entitlements copy basic's
   basic: 1,
   standard: 2,
   pro: 3,
@@ -80,6 +81,7 @@ export const TIER_PIPELINE_PARALLELISM: Record<string, number> = {
 // the user paid for, instead of the intended two-thirds.
 export const TIER_MAX_PIPELINE_COST_CREDITS: Record<string, number> = {
   free: 0,
+  payg: 3000, // derived tier — copies basic
   basic: 3000,
   standard: 8000,
   pro: 20000,