@genfeedai/workflow-engine 0.2.0

package/dist/executors/saas/brand-executor.js

@@ -0,0 +1,45 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+export class BrandExecutor extends BaseExecutor {
+  nodeType = 'brand';
+  resolver = null;
+  setResolver(resolver) {
+    this.resolver = resolver;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const brandId = node.config.brandId;
+    if (!brandId || typeof brandId !== 'string') {
+      errors.push('Brand ID is required');
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  async execute(input) {
+    const { node, context } = input;
+    if (!this.resolver) {
+      throw new Error('Brand resolver not configured');
+    }
+    const brandId = this.getRequiredConfig(node.config, 'brandId');
+    const brandContext = await this.resolver(brandId, context.organizationId);
+    if (!brandContext) {
+      throw new Error(`Brand ${brandId} not found or not accessible`);
+    }
+    return {
+      data: brandContext,
+      metadata: {
+        brandId: brandContext.brandId,
+        brandLabel: brandContext.label,
+      },
+    };
+  }
+}
+export function createBrandExecutor(resolver) {
+  const executor = new BrandExecutor();
+  if (resolver) {
+    executor.setResolver(resolver);
+  }
+  return executor;
+}

package/dist/executors/saas/cinematic-camera-presets.d.ts

@@ -0,0 +1,28 @@
+import type { CinematicColorGradeConfig } from '@workflow-engine/executors/saas/cinematic-color-grade-executor';
+import type { FilmGrainConfig } from '@workflow-engine/executors/saas/film-grain-executor';
+import type { LensEffectsConfig } from '@workflow-engine/executors/saas/lens-effects-executor';
+export interface CinematicCameraPreset {
+  id: string;
+  name: string;
+  camera: string;
+  description: string;
+  promptFragment: string;
+  colorGrade: CinematicColorGradeConfig;
+  filmGrain: FilmGrainConfig;
+  lensEffects: LensEffectsConfig;
+}
+export declare const CINEMATIC_CAMERA_PRESETS: Record<
+  string,
+  CinematicCameraPreset
+>;
+/**
+ * Get a camera preset by id.
+ */
+export declare function getCinematicCameraPreset(
+  id: string,
+): CinematicCameraPreset | undefined;
+/**
+ * List all available camera preset ids.
+ */
+export declare function listCinematicCameraPresetIds(): string[];
+//# sourceMappingURL=cinematic-camera-presets.d.ts.map

package/dist/executors/saas/cinematic-camera-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cinematic-camera-presets.d.ts","sourceRoot":"","sources":["../../../src/executors/saas/cinematic-camera-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAE/F,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,eAAe,CAAC;IAC3B,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAID,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAuN1E,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,GACT,qBAAqB,GAAG,SAAS,CAEnC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD"}

package/dist/executors/saas/cinematic-camera-presets.js

@@ -0,0 +1,225 @@
+const off = { enabled: false };
+export const CINEMATIC_CAMERA_PRESETS = {
+  // -------------------------------------------------------------------------
+  // 6. Commercial Clean — Sony Venice 2
+  // -------------------------------------------------------------------------
+  commercial_clean: {
+    camera: 'Sony Venice 2',
+    colorGrade: {
+      cameraProfile: 'sony_slog3',
+      contrast: 5,
+      highlights: 0,
+      lutIntensity: 0,
+      midtones: 5,
+      saturation: 5,
+      shadows: 0,
+      temperature: 6500,
+    },
+    description:
+      'Clean, polished look with accurate colors and minimal grain. Broadcast and commercial ready.',
+    filmGrain: {
+      animateGrain: false,
+      colorGrain: false,
+      intensity: 8,
+      size: 'fine',
+      stock: 'digital_noise',
+    },
+    id: 'commercial_clean',
+    lensEffects: {
+      barrelDistortion: { ...off, amount: 0 },
+      bloom: { enabled: true, intensity: 10, threshold: 90 },
+      chromaticAberration: { ...off, intensity: 0 },
+      vignette: { enabled: true, intensity: 8, softness: 90 },
+    },
+    name: 'Commercial Clean',
+    promptFragment:
+      'shot on Sony Venice 2, clean cinematic look, accurate colors, soft lighting, polished, commercial',
+  },
+  // -------------------------------------------------------------------------
+  // 2. Documentary Raw — RED V-Raptor XL
+  // -------------------------------------------------------------------------
+  documentary_raw: {
+    camera: 'RED V-Raptor XL',
+    colorGrade: {
+      cameraProfile: 'red_ippc2',
+      contrast: 25,
+      highlights: -5,
+      lutIntensity: 0,
+      midtones: 0,
+      saturation: -20,
+      shadows: -10,
+      temperature: 6200,
+    },
+    description:
+      'High-contrast, desaturated look with sharp detail. Raw and authentic feel.',
+    filmGrain: {
+      animateGrain: true,
+      colorGrain: true,
+      intensity: 35,
+      size: 'medium',
+      stock: '35mm_heavy',
+    },
+    id: 'documentary_raw',
+    lensEffects: {
+      barrelDistortion: { amount: 10, enabled: true },
+      bloom: { ...off, intensity: 0, threshold: 80 },
+      chromaticAberration: { ...off, intensity: 0 },
+      vignette: { enabled: true, intensity: 15, softness: 50 },
+    },
+    name: 'Documentary Raw',
+    promptFragment:
+      'shot on RED V-Raptor XL, handheld, natural lighting, documentary style, 8K downscaled',
+  },
+  // -------------------------------------------------------------------------
+  // 1. Hollywood Blockbuster — ARRI Alexa Mini LF
+  // -------------------------------------------------------------------------
+  hollywood_blockbuster: {
+    camera: 'ARRI Alexa Mini LF',
+    colorGrade: {
+      cameraProfile: 'arri_logc4',
+      contrast: 15,
+      highlights: 10,
+      lutIntensity: 0,
+      midtones: 5,
+      saturation: -10,
+      shadows: -15,
+      temperature: 5800,
+    },
+    description:
+      'Rich cinematic look with deep shadows and warm highlights. The gold standard for feature films.',
+    filmGrain: {
+      animateGrain: true,
+      colorGrain: false,
+      intensity: 25,
+      size: 'fine',
+      stock: '35mm_fine',
+    },
+    id: 'hollywood_blockbuster',
+    lensEffects: {
+      barrelDistortion: { amount: 0, enabled: false },
+      bloom: { enabled: true, intensity: 15, threshold: 85 },
+      chromaticAberration: { enabled: true, intensity: 8 },
+      vignette: { enabled: true, intensity: 30, softness: 70 },
+    },
+    name: 'Hollywood Blockbuster',
+    promptFragment:
+      'shot on ARRI Alexa Mini LF, anamorphic lens, cinematic lighting, film grain, shallow depth of field',
+  },
+  // -------------------------------------------------------------------------
+  // 4. Indie Film — Blackmagic Pocket 6K Pro
+  // -------------------------------------------------------------------------
+  indie_film: {
+    camera: 'Blackmagic Pocket 6K Pro',
+    colorGrade: {
+      cameraProfile: 'bmpcc_film',
+      contrast: 30,
+      highlights: -10,
+      lutIntensity: 0,
+      midtones: -5,
+      saturation: -15,
+      shadows: -25,
+      temperature: 5500,
+    },
+    description:
+      'Gritty, textured look with crushed blacks and muted tones. Festival-ready aesthetic.',
+    filmGrain: {
+      animateGrain: true,
+      colorGrain: true,
+      intensity: 45,
+      size: 'medium',
+      stock: '16mm',
+    },
+    id: 'indie_film',
+    lensEffects: {
+      barrelDistortion: { amount: 8, enabled: true },
+      bloom: { ...off, intensity: 0, threshold: 80 },
+      chromaticAberration: { enabled: true, intensity: 15 },
+      vignette: { enabled: true, intensity: 40, softness: 50 },
+    },
+    name: 'Indie Film',
+    promptFragment:
+      'shot on Blackmagic Pocket 6K Pro, indie film look, moody lighting, crushed blacks, textured',
+  },
+  // -------------------------------------------------------------------------
+  // 3. Social Media Cinematic — Canon C70
+  // -------------------------------------------------------------------------
+  social_media_cinematic: {
+    camera: 'Canon C70',
+    colorGrade: {
+      cameraProfile: 'canon_clog3',
+      contrast: 10,
+      highlights: 5,
+      lutIntensity: 0,
+      midtones: 10,
+      saturation: 20,
+      shadows: 5,
+      temperature: 6800,
+    },
+    description:
+      'Vibrant, punchy colors optimized for mobile screens. Bright and engaging.',
+    filmGrain: {
+      animateGrain: true,
+      colorGrain: false,
+      intensity: 10,
+      size: 'fine',
+      stock: '35mm_fine',
+    },
+    id: 'social_media_cinematic',
+    lensEffects: {
+      barrelDistortion: { ...off, amount: 0 },
+      bloom: { enabled: true, intensity: 20, threshold: 75 },
+      chromaticAberration: { ...off, intensity: 0 },
+      vignette: { enabled: true, intensity: 10, softness: 80 },
+    },
+    name: 'Social Media Cinematic',
+    promptFragment:
+      'shot on Canon C70, vibrant colors, soft lighting, social media ready, vertical format',
+  },
+  // -------------------------------------------------------------------------
+  // 5. Vintage 35mm — Kodak Vision3 500T
+  // -------------------------------------------------------------------------
+  vintage_35mm: {
+    camera: 'Kodak Vision3 500T',
+    colorGrade: {
+      cameraProfile: 'kodak_500t',
+      contrast: 20,
+      highlights: 15,
+      lutIntensity: 0,
+      midtones: 10,
+      saturation: -5,
+      shadows: -10,
+      temperature: 4800,
+    },
+    description:
+      'Warm, nostalgic film look with heavy grain and halation. Classic celluloid aesthetic.',
+    filmGrain: {
+      animateGrain: true,
+      colorGrain: true,
+      intensity: 60,
+      size: 'coarse',
+      stock: '35mm_heavy',
+    },
+    id: 'vintage_35mm',
+    lensEffects: {
+      barrelDistortion: { ...off, amount: 0 },
+      bloom: { enabled: true, intensity: 35, threshold: 70 },
+      chromaticAberration: { enabled: true, intensity: 20 },
+      vignette: { enabled: true, intensity: 35, softness: 60 },
+    },
+    name: 'Vintage 35mm',
+    promptFragment:
+      'shot on Kodak Vision3 500T film stock, 35mm, warm tones, heavy grain, halation, nostalgic',
+  },
+};
+/**
+ * Get a camera preset by id.
+ */
+export function getCinematicCameraPreset(id) {
+  return CINEMATIC_CAMERA_PRESETS[id];
+}
+/**
+ * List all available camera preset ids.
+ */
+export function listCinematicCameraPresetIds() {
+  return Object.keys(CINEMATIC_CAMERA_PRESETS);
+}

package/dist/executors/saas/cinematic-color-grade-executor.d.ts

@@ -0,0 +1,73 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type CameraProfile =
+  | 'arri_logc4'
+  | 'red_ippc2'
+  | 'sony_slog3'
+  | 'canon_clog3'
+  | 'bmpcc_film'
+  | 'kodak_500t';
+export interface CinematicColorGradeConfig {
+  cameraProfile: CameraProfile;
+  contrast: number;
+  saturation: number;
+  temperature: number;
+  shadows: number;
+  midtones: number;
+  highlights: number;
+  customLUT?: string;
+  lutIntensity: number;
+}
+export interface CinematicColorGradeResult {
+  outputVideoUrl: string;
+  jobId: string;
+}
+export type CinematicColorGradeProcessor = (params: {
+  organizationId: string;
+  videoUrl: string;
+  filterChain: string;
+  config: CinematicColorGradeConfig;
+  customLUT?: string;
+}) => Promise<CinematicColorGradeResult>;
+export declare const CAMERA_PROFILE_CURVES: Record<CameraProfile, string>;
+/**
+ * Builds a cinematic FFmpeg filter chain from color grade config.
+ *
+ * Pipeline order:
+ *   1. Camera profile curve (log-to-display transform)
+ *   2. Color balance (shadows / midtones / highlights + temperature)
+ *   3. Eq (contrast + saturation)
+ *   4. LUT (if provided, blended at lutIntensity)
+ */
+export declare function buildCinematicColorGradeFilterChain(
+  config: CinematicColorGradeConfig,
+): string;
+/**
+ * Cinematic Color Grade Executor
+ *
+ * Applies cinematic-grade color grading using camera profile curves,
+ * 3-way color balance (shadows / midtones / highlights), temperature
+ * control, and optional LUT application.
+ *
+ * Node Type: cinematicColorGrade
+ * Category: processing
+ */
+export declare class CinematicColorGradeExecutor extends BaseExecutor {
+  readonly nodeType = 'cinematicColorGrade';
+  private processor;
+  setProcessor(processor: CinematicColorGradeProcessor): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(_node: ExecutableNode): number;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createCinematicColorGradeExecutor(
+  processor?: CinematicColorGradeProcessor,
+): CinematicColorGradeExecutor;
+//# sourceMappingURL=cinematic-color-grade-executor.d.ts.map

package/dist/executors/saas/cinematic-color-grade-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cinematic-color-grade-executor.d.ts","sourceRoot":"","sources":["../../../src/executors/saas/cinematic-color-grade-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAOzC,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAa/D,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,yBAAyB,GAChC,MAAM,CAsCR;AAkCD;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;IAC3D,QAAQ,CAAC,QAAQ,yBAAyB;IAC1C,OAAO,CAAC,SAAS,CAA6C;IAE9D,YAAY,CAAC,SAAS,EAAE,4BAA4B,GAAG,IAAI;IAI3D,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAsBpE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAIrC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAwD7D;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,CAAC,EAAE,4BAA4B,GACvC,2BAA2B,CAM7B"}

package/dist/executors/saas/cinematic-color-grade-executor.js

@@ -0,0 +1,169 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+// ---------------------------------------------------------------------------
+// Camera profile base curves (applied before user adjustments)
+// These simulate log-to-rec709 transforms for each camera system.
+// ---------------------------------------------------------------------------
+export const CAMERA_PROFILE_CURVES = {
+  arri_logc4:
+    'curves=r=0/0 0.25/0.20 0.5/0.55 0.75/0.85 1/1:g=0/0 0.25/0.18 0.5/0.52 0.75/0.83 1/1:b=0/0 0.25/0.15 0.5/0.48 0.75/0.80 1/1',
+  bmpcc_film:
+    'curves=r=0/0 0.2/0.18 0.5/0.54 0.8/0.88 1/1:g=0/0 0.2/0.16 0.5/0.50 0.8/0.85 1/1:b=0/0 0.2/0.14 0.5/0.46 0.8/0.80 1/1',
+  canon_clog3:
+    'curves=r=0/0 0.25/0.22 0.5/0.52 0.75/0.82 1/1:g=0/0 0.25/0.20 0.5/0.50 0.75/0.80 1/1:b=0/0 0.25/0.18 0.5/0.48 0.75/0.78 1/1',
+  kodak_500t:
+    'curves=r=0/0.02 0.25/0.22 0.5/0.55 0.75/0.82 1/0.98:g=0/0.01 0.25/0.18 0.5/0.48 0.75/0.78 1/0.96:b=0/0 0.25/0.15 0.5/0.42 0.75/0.72 1/0.92',
+  red_ippc2:
+    'curves=r=0/0 0.2/0.15 0.5/0.55 0.8/0.90 1/1:g=0/0 0.2/0.12 0.5/0.50 0.8/0.88 1/1:b=0/0 0.2/0.10 0.5/0.45 0.8/0.82 1/1',
+  sony_slog3:
+    'curves=r=0/0 0.3/0.22 0.5/0.50 0.7/0.78 1/1:g=0/0 0.3/0.20 0.5/0.48 0.7/0.76 1/1:b=0/0 0.3/0.18 0.5/0.46 0.7/0.74 1/1',
+};
+// ---------------------------------------------------------------------------
+// Filter chain builder
+// ---------------------------------------------------------------------------
+/**
+ * Builds a cinematic FFmpeg filter chain from color grade config.
+ *
+ * Pipeline order:
+ *   1. Camera profile curve (log-to-display transform)
+ *   2. Color balance (shadows / midtones / highlights + temperature)
+ *   3. Eq (contrast + saturation)
+ *   4. LUT (if provided, blended at lutIntensity)
+ */
+export function buildCinematicColorGradeFilterChain(config) {
+  const filters = [];
+  // 1. Camera profile curves
+  filters.push(CAMERA_PROFILE_CURVES[config.cameraProfile]);
+  // 2. Color balance from shadows / midtones / highlights + temperature
+  const tempShift = (config.temperature - 6500) / 8000; // neutral = 6500K
+  const shadowR = (config.shadows / 50) * 0.15 + tempShift * 0.1;
+  const shadowB = (-config.shadows / 50) * 0.1 - tempShift * 0.1;
+  const midR = (config.midtones / 50) * 0.12 + tempShift * 0.08;
+  const midB = (-config.midtones / 50) * 0.08 - tempShift * 0.08;
+  const highR = (config.highlights / 50) * 0.1 + tempShift * 0.06;
+  const highB = (-config.highlights / 50) * 0.06 - tempShift * 0.06;
+  filters.push(
+    `colorbalance=rs=${shadowR.toFixed(3)}:bs=${shadowB.toFixed(3)}:rm=${midR.toFixed(3)}:bm=${midB.toFixed(3)}:rh=${highR.toFixed(3)}:bh=${highB.toFixed(3)}`,
+  );
+  // 3. Contrast & saturation via eq
+  const contrastVal = 1 + config.contrast / 100; // -100→0, 0→1, 100→2
+  const satVal = 1 + config.saturation / 100;
+  filters.push(
+    `eq=contrast=${contrastVal.toFixed(2)}:saturation=${satVal.toFixed(2)}`,
+  );
+  // 4. LUT application (only if customLUT is provided)
+  // The actual LUT loading is handled by the processor; we just signal it
+  // via the filter chain with a placeholder that the processor replaces.
+  if (config.customLUT && config.lutIntensity > 0) {
+    const intensity = config.lutIntensity / 100;
+    // split → lut3d → merge at intensity via blend
+    filters.push(
+      `split[cg_main][cg_lut];[cg_lut]lut3d='${config.customLUT}'[cg_luted];[cg_main][cg_luted]blend=all_mode=normal:all_opacity=${intensity.toFixed(2)}`,
+    );
+  }
+  return filters.join(',');
+}
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+const VALID_CAMERA_PROFILES = [
+  'arri_logc4',
+  'red_ippc2',
+  'sony_slog3',
+  'canon_clog3',
+  'bmpcc_film',
+  'kodak_500t',
+];
+function validateRange(value, field, min, max, errors) {
+  if (
+    value !== undefined &&
+    (typeof value !== 'number' || value < min || value > max)
+  ) {
+    errors.push(`${field} must be a number between ${min} and ${max}`);
+  }
+}
+// ---------------------------------------------------------------------------
+// Executor
+// ---------------------------------------------------------------------------
+/**
+ * Cinematic Color Grade Executor
+ *
+ * Applies cinematic-grade color grading using camera profile curves,
+ * 3-way color balance (shadows / midtones / highlights), temperature
+ * control, and optional LUT application.
+ *
+ * Node Type: cinematicColorGrade
+ * Category: processing
+ */
+export class CinematicColorGradeExecutor extends BaseExecutor {
+  nodeType = 'cinematicColorGrade';
+  processor = null;
+  setProcessor(processor) {
+    this.processor = processor;
+  }
+  validate(node) {
+    const base = super.validate(node);
+    const errors = [...base.errors];
+    const profile = node.config.cameraProfile;
+    if (profile && !VALID_CAMERA_PROFILES.includes(profile)) {
+      errors.push(
+        `Invalid cameraProfile. Must be one of: ${VALID_CAMERA_PROFILES.join(', ')}`,
+      );
+    }
+    validateRange(node.config.contrast, 'contrast', -100, 100, errors);
+    validateRange(node.config.saturation, 'saturation', -100, 100, errors);
+    validateRange(node.config.temperature, 'temperature', 2000, 10000, errors);
+    validateRange(node.config.shadows, 'shadows', -50, 50, errors);
+    validateRange(node.config.midtones, 'midtones', -50, 50, errors);
+    validateRange(node.config.highlights, 'highlights', -50, 50, errors);
+    validateRange(node.config.lutIntensity, 'lutIntensity', 0, 100, errors);
+    return { errors, valid: errors.length === 0 };
+  }
+  estimateCost(_node) {
+    return 2; // Video processing credits
+  }
+  async execute(input) {
+    const { node, inputs, context } = input;
+    if (!this.processor) {
+      throw new Error('Cinematic color grade processor not configured');
+    }
+    const videoUrl = this.getRequiredInput(inputs, 'videoUrl');
+    const config = {
+      cameraProfile: this.getOptionalConfig(
+        node.config,
+        'cameraProfile',
+        'arri_logc4',
+      ),
+      contrast: this.getOptionalConfig(node.config, 'contrast', 0),
+      customLUT: this.getOptionalConfig(node.config, 'customLUT', undefined),
+      highlights: this.getOptionalConfig(node.config, 'highlights', 0),
+      lutIntensity: this.getOptionalConfig(node.config, 'lutIntensity', 100),
+      midtones: this.getOptionalConfig(node.config, 'midtones', 0),
+      saturation: this.getOptionalConfig(node.config, 'saturation', 0),
+      shadows: this.getOptionalConfig(node.config, 'shadows', 0),
+      temperature: this.getOptionalConfig(node.config, 'temperature', 6500),
+    };
+    const filterChain = buildCinematicColorGradeFilterChain(config);
+    const result = await this.processor({
+      config,
+      customLUT: config.customLUT,
+      filterChain,
+      organizationId: context.organizationId,
+      videoUrl,
+    });
+    return {
+      data: result.outputVideoUrl,
+      metadata: {
+        cameraProfile: config.cameraProfile,
+        filterChain,
+        jobId: result.jobId,
+      },
+    };
+  }
+}
+export function createCinematicColorGradeExecutor(processor) {
+  const executor = new CinematicColorGradeExecutor();
+  if (processor) {
+    executor.setProcessor(processor);
+  }
+  return executor;
+}

package/dist/executors/saas/color-grade-executor.d.ts

@@ -0,0 +1,73 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type ColorGradeMode = 'preset' | 'custom' | 'ai-style';
+export type ColorGradePreset =
+  | 'instagram-warm'
+  | 'instagram-cool'
+  | 'instagram-moody'
+  | 'instagram-bright'
+  | 'custom';
+export interface ColorGradeParams {
+  warmth: number;
+  contrast: number;
+  saturation: number;
+  vignette: number;
+  grain: number;
+  sharpness: number;
+}
+export interface ColorGradeResult {
+  outputImageUrl: string;
+  jobId: string;
+}
+/**
+ * Preset configurations mapping to FFmpeg filter parameters.
+ * Each preset defines a fixed set of color grading values (0-100 scale).
+ */
+export declare const COLOR_GRADE_PRESETS: Record<
+  ColorGradePreset,
+  ColorGradeParams
+>;
+/**
+ * Builds an FFmpeg filter_complex string from color grade parameters.
+ * Parameters are on a 0-100 scale, mapped to FFmpeg-appropriate ranges.
+ */
+export declare function buildFfmpegFilterChain(
+  params: ColorGradeParams,
+): string;
+export type ColorGradeProcessor = (params: {
+  organizationId: string;
+  imageUrl: string;
+  mode: ColorGradeMode;
+  preset: ColorGradePreset;
+  filterChain: string;
+  styleReferenceImage?: string;
+}) => Promise<ColorGradeResult>;
+/**
+ * Color Grade Executor
+ *
+ * Applies Instagram-style color grading to images via FFmpeg filters
+ * or AI style transfer. Supports preset modes (warm, cool, moody, bright)
+ * and custom parameter tuning.
+ *
+ * Node Type: colorGrade
+ * Category: effects
+ */
+export declare class ColorGradeExecutor extends BaseExecutor {
+  readonly nodeType = 'colorGrade';
+  private processor;
+  setProcessor(processor: ColorGradeProcessor): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(node: ExecutableNode): number;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createColorGradeExecutor(
+  processor?: ColorGradeProcessor,
+): ColorGradeExecutor;
+//# sourceMappingURL=color-grade-executor.d.ts.map

package/dist/executors/saas/color-grade-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-grade-executor.d.ts","sourceRoot":"","sources":["../../../src/executors/saas/color-grade-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,QAAQ,CAAC;AAEb,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAyC1E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyCvE;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEhC;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,QAAQ,CAAC,QAAQ,gBAAgB;IACjC,OAAO,CAAC,SAAS,CAAoC;IAErD,YAAY,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI;IAIlD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAsDpE,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAMpC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CA0F7D;AAED,wBAAgB,wBAAwB,CACtC,SAAS,CAAC,EAAE,mBAAmB,GAC9B,kBAAkB,CAMpB"}