@genfeedai/workflow-engine 0.2.0

package/dist/src/executors/saas/index.js

@@ -0,0 +1,50 @@
+export * from '@workflow-engine/executors/saas/beat-analysis-executor';
+export * from '@workflow-engine/executors/saas/beat-sync-editor-executor';
+export * from '@workflow-engine/executors/saas/brand-asset-executor';
+export * from '@workflow-engine/executors/saas/brand-context-executor';
+export * from '@workflow-engine/executors/saas/brand-executor';
+// Cinematic post-production executors
+export * from '@workflow-engine/executors/saas/cinematic-camera-presets';
+export * from '@workflow-engine/executors/saas/cinematic-color-grade-executor';
+export * from '@workflow-engine/executors/saas/condition-executor';
+export * from '@workflow-engine/executors/saas/delay-executor';
+// Social trigger executors
+export * from '@workflow-engine/executors/saas/engagement-trigger-executor';
+export * from '@workflow-engine/executors/saas/film-grain-executor';
+// AI generation executors
+export * from '@workflow-engine/executors/saas/image-gen-executor';
+export * from '@workflow-engine/executors/saas/keyword-trigger-executor';
+export * from '@workflow-engine/executors/saas/lens-effects-executor';
+// Lip sync executor
+export * from '@workflow-engine/executors/saas/lip-sync-executor';
+export * from '@workflow-engine/executors/saas/mention-trigger-executor';
+export * from '@workflow-engine/executors/saas/music-source-executor';
+export * from '@workflow-engine/executors/saas/new-follower-trigger-executor';
+export * from '@workflow-engine/executors/saas/new-like-trigger-executor';
+export * from '@workflow-engine/executors/saas/new-repost-trigger-executor';
+// Social action executors
+export * from '@workflow-engine/executors/saas/post-reply-executor';
+// Prompt construction executor
+export * from '@workflow-engine/executors/saas/prompt-constructor-executor';
+export * from '@workflow-engine/executors/saas/publish-executor';
+// Reframe executor
+export * from '@workflow-engine/executors/saas/reframe-executor';
+export * from '@workflow-engine/executors/saas/rss-input-executor';
+export * from '@workflow-engine/executors/saas/send-dm-executor';
+export {
+  createSocialPublishExecutor,
+  SocialPublishExecutor,
+  // Note: SocialPlatform is already exported from publish-executor
+} from '@workflow-engine/executors/saas/social-publish-executor';
+export * from '@workflow-engine/executors/saas/sound-overlay-executor';
+// Text to speech executor
+export * from '@workflow-engine/executors/saas/text-to-speech-executor';
+export * from '@workflow-engine/executors/saas/trend-trigger-executor';
+export * from '@workflow-engine/executors/saas/tweet-input-executor';
+export * from '@workflow-engine/executors/saas/tweet-remix-executor';
+// Upscale executor
+export * from '@workflow-engine/executors/saas/upscale-executor';
+// Beat-synced video editor executors
+export * from '@workflow-engine/executors/saas/video-input-executor';
+// Voice change executor
+export * from '@workflow-engine/executors/saas/voice-change-executor';

package/dist/src/executors/saas/keyword-trigger-executor.d.ts

@@ -0,0 +1,56 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type KeywordTriggerPlatform = 'twitter' | 'instagram' | 'threads';
+export type KeywordMatchMode = 'exact' | 'contains' | 'regex';
+export interface KeywordTriggerOutput {
+  /** The post/tweet ID containing the keyword match */
+  postId: string;
+  /** URL of the post */
+  postUrl: string;
+  /** Full text of the post */
+  text: string;
+  /** The keyword or phrase that matched */
+  matchedKeyword: string;
+  /** Author user ID */
+  authorId: string;
+  /** Author username */
+  authorUsername: string;
+  /** Platform */
+  platform: KeywordTriggerPlatform;
+  /** Timestamp of the post */
+  detectedAt: string;
+}
+export type KeywordChecker = (params: {
+  organizationId: string;
+  platform: KeywordTriggerPlatform;
+  keywords: string[];
+  excludeKeywords: string[];
+  matchMode: KeywordMatchMode;
+  caseSensitive: boolean;
+  lastPostId: string | null;
+}) => Promise<KeywordTriggerOutput | null>;
+/**
+ * Keyword Trigger Executor
+ *
+ * Starts a workflow when a keyword or phrase is detected in incoming social posts.
+ * Polls posts at configurable intervals and deduplicates.
+ *
+ * Node Type: keywordTrigger
+ */
+export declare class KeywordTriggerExecutor extends BaseExecutor {
+  readonly nodeType = 'keywordTrigger';
+  private checker;
+  setChecker(checker: KeywordChecker): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+  estimateCost(_node: ExecutableNode): number;
+}
+export declare function createKeywordTriggerExecutor(): KeywordTriggerExecutor;
+//# sourceMappingURL=keyword-trigger-executor.d.ts.map

package/dist/src/executors/saas/keyword-trigger-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-trigger-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/keyword-trigger-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,sBAAsB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,QAAQ,EAAE,sBAAsB,CAAC;IACjC,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAM3C;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,QAAQ,oBAAoB;IACrC,OAAO,CAAC,OAAO,CAA+B;IAE9C,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAsC9D,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA6D5D,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CAG5C;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAErE"}

package/dist/src/executors/saas/keyword-trigger-executor.js

@@ -0,0 +1,96 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+// =============================================================================
+// EXECUTOR
+// =============================================================================
+/**
+ * Keyword Trigger Executor
+ *
+ * Starts a workflow when a keyword or phrase is detected in incoming social posts.
+ * Polls posts at configurable intervals and deduplicates.
+ *
+ * Node Type: keywordTrigger
+ */
+export class KeywordTriggerExecutor extends BaseExecutor {
+  nodeType = 'keywordTrigger';
+  checker = null;
+  setChecker(checker) {
+    this.checker = checker;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const platform = node.config.platform;
+    const validPlatforms = ['twitter', 'instagram', 'threads'];
+    if (!platform || !validPlatforms.includes(platform)) {
+      errors.push(
+        `Invalid platform. Must be one of: ${validPlatforms.join(', ')}`,
+      );
+    }
+    const keywords = node.config.keywords;
+    if (!Array.isArray(keywords) || keywords.length === 0) {
+      errors.push('At least one keyword is required');
+    }
+    const matchMode = node.config.matchMode;
+    const validMatchModes = ['exact', 'contains', 'regex'];
+    if (matchMode !== undefined && !validMatchModes.includes(matchMode)) {
+      errors.push(
+        `Invalid match mode. Must be one of: ${validMatchModes.join(', ')}`,
+      );
+    }
+    return { errors, valid: errors.length === 0 };
+  }
+  async execute(input) {
+    const { node, context } = input;
+    if (!this.checker) {
+      throw new Error('Keyword checker not configured');
+    }
+    const platform = this.getRequiredConfig(node.config, 'platform');
+    const keywords = this.getRequiredConfig(node.config, 'keywords');
+    const excludeKeywords = this.getOptionalConfig(
+      node.config,
+      'excludeKeywords',
+      [],
+    );
+    const matchMode = this.getOptionalConfig(
+      node.config,
+      'matchMode',
+      'contains',
+    );
+    const caseSensitive = this.getOptionalConfig(
+      node.config,
+      'caseSensitive',
+      false,
+    );
+    const lastPostId = this.getOptionalConfig(node.config, 'lastPostId', null);
+    const result = await this.checker({
+      caseSensitive,
+      excludeKeywords,
+      keywords,
+      lastPostId,
+      matchMode,
+      organizationId: context.organizationId,
+      platform,
+    });
+    if (!result) {
+      return {
+        data: null,
+        metadata: { matched: false, platform },
+      };
+    }
+    return {
+      data: result,
+      metadata: {
+        matched: true,
+        matchedKeyword: result.matchedKeyword,
+        platform,
+        postId: result.postId,
+      },
+    };
+  }
+  estimateCost(_node) {
+    return 0;
+  }
+}
+export function createKeywordTriggerExecutor() {
+  return new KeywordTriggerExecutor();
+}

package/dist/src/executors/saas/lens-effects-executor.d.ts

@@ -0,0 +1,76 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export interface VignetteConfig {
+  enabled: boolean;
+  intensity: number;
+  softness: number;
+}
+export interface ChromaticAberrationConfig {
+  enabled: boolean;
+  intensity: number;
+}
+export interface BarrelDistortionConfig {
+  enabled: boolean;
+  amount: number;
+}
+export interface BloomConfig {
+  enabled: boolean;
+  threshold: number;
+  intensity: number;
+}
+export interface LensEffectsConfig {
+  vignette: VignetteConfig;
+  chromaticAberration: ChromaticAberrationConfig;
+  barrelDistortion: BarrelDistortionConfig;
+  bloom: BloomConfig;
+}
+export interface LensEffectsResult {
+  outputVideoUrl: string;
+  jobId: string;
+}
+export type LensEffectsProcessor = (params: {
+  organizationId: string;
+  videoUrl: string;
+  filterChain: string;
+  config: LensEffectsConfig;
+}) => Promise<LensEffectsResult>;
+/**
+ * Builds an FFmpeg filter chain for lens effects.
+ *
+ * Pipeline (each effect is optional):
+ *   1. Vignette
+ *   2. Chromatic aberration (rgbashift)
+ *   3. Barrel distortion (lenscorrection)
+ *   4. Bloom (threshold → blur → blend)
+ */
+export declare function buildLensEffectsFilterChain(
+  config: LensEffectsConfig,
+): string;
+/**
+ * Lens Effects Executor
+ *
+ * Applies cinematic lens effects: vignette, chromatic aberration,
+ * barrel distortion, and bloom via FFmpeg filters.
+ *
+ * Node Type: lensEffects
+ * Category: processing
+ */
+export declare class LensEffectsExecutor extends BaseExecutor {
+  readonly nodeType = 'lensEffects';
+  private processor;
+  setProcessor(processor: LensEffectsProcessor): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(_node: ExecutableNode): number;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createLensEffectsExecutor(
+  processor?: LensEffectsProcessor,
+): LensEffectsExecutor;
+//# sourceMappingURL=lens-effects-executor.d.ts.map

package/dist/src/executors/saas/lens-effects-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-effects-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/lens-effects-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,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,mBAAmB,EAAE,yBAAyB,CAAC;IAC/C,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAMjC;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA8C7E;AAiCD;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,QAAQ,CAAC,QAAQ,iBAAiB;IAClC,OAAO,CAAC,SAAS,CAAqC;IAEtD,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAInD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAyCpE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAIrC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAyD7D;AAED,wBAAgB,yBAAyB,CACvC,SAAS,CAAC,EAAE,oBAAoB,GAC/B,mBAAmB,CAMrB"}

package/dist/src/executors/saas/lens-effects-executor.js

@@ -0,0 +1,184 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+// ---------------------------------------------------------------------------
+// Filter chain builder
+// ---------------------------------------------------------------------------
+/**
+ * Builds an FFmpeg filter chain for lens effects.
+ *
+ * Pipeline (each effect is optional):
+ *   1. Vignette
+ *   2. Chromatic aberration (rgbashift)
+ *   3. Barrel distortion (lenscorrection)
+ *   4. Bloom (threshold → blur → blend)
+ */
+export function buildLensEffectsFilterChain(config) {
+  const filters = [];
+  // 1. Vignette
+  if (config.vignette.enabled && config.vignette.intensity > 0) {
+    const angle = (config.vignette.intensity / 100) * (Math.PI / 4);
+    // Softness controls the vignette aspect — higher = wider soft edge
+    const aspect = 0.3 + (config.vignette.softness / 100) * 0.7;
+    filters.push(
+      `vignette=angle=${angle.toFixed(4)}:x0=iw/2:y0=ih/2:mode=forward:aspect=${aspect.toFixed(2)}`,
+    );
+  }
+  // 2. Chromatic aberration via rgbashift
+  if (
+    config.chromaticAberration.enabled &&
+    config.chromaticAberration.intensity > 0
+  ) {
+    const shift = Math.round((config.chromaticAberration.intensity / 100) * 8);
+    filters.push(
+      `rgbashift=rh=${-shift}:bh=${shift}:rv=${Math.round(shift * 0.3)}:bv=${Math.round(-shift * 0.3)}`,
+    );
+  }
+  // 3. Barrel distortion via lenscorrection
+  if (config.barrelDistortion.enabled && config.barrelDistortion.amount !== 0) {
+    const k1 = (config.barrelDistortion.amount / 100) * -0.3;
+    const k2 = (config.barrelDistortion.amount / 100) * -0.05;
+    filters.push(`lenscorrection=k1=${k1.toFixed(4)}:k2=${k2.toFixed(4)}`);
+  }
+  // 4. Bloom effect (split → threshold → blur → blend)
+  if (config.bloom.enabled && config.bloom.intensity > 0) {
+    const thresholdVal = Math.round(255 - (config.bloom.threshold / 100) * 200);
+    const blurSize = Math.round(10 + (config.bloom.intensity / 100) * 40);
+    const opacity = (config.bloom.intensity / 100) * 0.6;
+    filters.push(
+      `split[le_main][le_bloom];[le_bloom]lutyuv=y='if(gt(val,${thresholdVal}),val,0)',gblur=sigma=${blurSize}[le_bloomed];[le_main][le_bloomed]blend=all_mode=screen:all_opacity=${opacity.toFixed(2)}`,
+    );
+  }
+  if (filters.length === 0) {
+    return 'null'; // FFmpeg passthrough
+  }
+  return filters.join(',');
+}
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+function validateSubConfig(obj, name, fields, errors) {
+  if (obj === undefined) return;
+  if (typeof obj !== 'object' || obj === null) {
+    errors.push(`${name} must be an object`);
+    return;
+  }
+  const rec = obj;
+  for (const { key, min, max } of fields) {
+    const val = rec[key];
+    if (
+      val !== undefined &&
+      (typeof val !== 'number' || val < min || val > max)
+    ) {
+      errors.push(`${name}.${key} must be a number between ${min} and ${max}`);
+    }
+  }
+}
+// ---------------------------------------------------------------------------
+// Executor
+// ---------------------------------------------------------------------------
+/**
+ * Lens Effects Executor
+ *
+ * Applies cinematic lens effects: vignette, chromatic aberration,
+ * barrel distortion, and bloom via FFmpeg filters.
+ *
+ * Node Type: lensEffects
+ * Category: processing
+ */
+export class LensEffectsExecutor extends BaseExecutor {
+  nodeType = 'lensEffects';
+  processor = null;
+  setProcessor(processor) {
+    this.processor = processor;
+  }
+  validate(node) {
+    const base = super.validate(node);
+    const errors = [...base.errors];
+    validateSubConfig(
+      node.config.vignette,
+      'vignette',
+      [
+        { key: 'intensity', max: 100, min: 0 },
+        { key: 'softness', max: 100, min: 0 },
+      ],
+      errors,
+    );
+    validateSubConfig(
+      node.config.chromaticAberration,
+      'chromaticAberration',
+      [{ key: 'intensity', max: 100, min: 0 }],
+      errors,
+    );
+    validateSubConfig(
+      node.config.barrelDistortion,
+      'barrelDistortion',
+      [{ key: 'amount', max: 100, min: -100 }],
+      errors,
+    );
+    validateSubConfig(
+      node.config.bloom,
+      'bloom',
+      [
+        { key: 'threshold', max: 100, min: 0 },
+        { key: 'intensity', max: 100, min: 0 },
+      ],
+      errors,
+    );
+    return { errors, valid: errors.length === 0 };
+  }
+  estimateCost(_node) {
+    return 2;
+  }
+  async execute(input) {
+    const { node, inputs, context } = input;
+    if (!this.processor) {
+      throw new Error('Lens effects processor not configured');
+    }
+    const videoUrl = this.getRequiredInput(inputs, 'videoUrl');
+    const _defaultSub = { enabled: false, intensity: 0 };
+    const config = {
+      barrelDistortion: {
+        amount: 0,
+        enabled: false,
+        ...node.config.barrelDistortion,
+      },
+      bloom: {
+        enabled: false,
+        intensity: 0,
+        threshold: 80,
+        ...node.config.bloom,
+      },
+      chromaticAberration: {
+        enabled: false,
+        intensity: 0,
+        ...node.config.chromaticAberration,
+      },
+      vignette: {
+        enabled: true,
+        intensity: 0,
+        softness: 50,
+        ...node.config.vignette,
+      },
+    };
+    const filterChain = buildLensEffectsFilterChain(config);
+    const result = await this.processor({
+      config,
+      filterChain,
+      organizationId: context.organizationId,
+      videoUrl,
+    });
+    return {
+      data: result.outputVideoUrl,
+      metadata: {
+        filterChain,
+        jobId: result.jobId,
+      },
+    };
+  }
+}
+export function createLensEffectsExecutor(processor) {
+  const executor = new LensEffectsExecutor();
+  if (processor) {
+    executor.setProcessor(processor);
+  }
+  return executor;
+}

package/dist/src/executors/saas/lip-sync-executor.d.ts

@@ -0,0 +1,45 @@
+import type { ExecutionContext } from '@workflow-engine/execution/engine';
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export interface LipSyncResult {
+  videoUrl: string;
+}
+/**
+ * Resolver that generates a lip-synced video from media + audio.
+ * The actual implementation is injected at runtime from the NestJS service layer.
+ */
+export type LipSyncResolver = (
+  mediaUrl: string,
+  audioUrl: string,
+  options: {
+    mode?: 'video' | 'image';
+  },
+  context: ExecutionContext,
+  node: ExecutableNode,
+) => Promise<LipSyncResult>;
+/**
+ * Lip Sync Executor
+ *
+ * Generates a lip-synced video from a source image/video and audio input.
+ * Uses HeyGen (or another provider) as the backend for lip sync generation.
+ *
+ * Node Type: lipSync
+ * Category: ai
+ */
+export declare class LipSyncExecutor extends BaseExecutor {
+  readonly nodeType = 'lipSync';
+  private resolver;
+  setResolver(resolver: LipSyncResolver): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(_node: ExecutableNode): number;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createLipSyncExecutor(): LipSyncExecutor;
+//# sourceMappingURL=lip-sync-executor.d.ts.map

package/dist/src/executors/saas/lip-sync-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lip-sync-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/lip-sync-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,EACrC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,cAAc,KACjB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,QAAQ,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAgC;IAEhD,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI5C,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAepE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAIrC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAqC7D;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/src/executors/saas/lip-sync-executor.js

@@ -0,0 +1,61 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+/**
+ * Lip Sync Executor
+ *
+ * Generates a lip-synced video from a source image/video and audio input.
+ * Uses HeyGen (or another provider) as the backend for lip sync generation.
+ *
+ * Node Type: lipSync
+ * Category: ai
+ */
+export class LipSyncExecutor extends BaseExecutor {
+  nodeType = 'lipSync';
+  resolver = null;
+  setResolver(resolver) {
+    this.resolver = resolver;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const mode = node.config.mode;
+    if (mode && !['video', 'image'].includes(mode)) {
+      errors.push('Invalid mode. Must be: video or image');
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  estimateCost(_node) {
+    return 10; // Lip sync is compute-heavy
+  }
+  async execute(input) {
+    const { node, inputs } = input;
+    if (!this.resolver) {
+      throw new Error('LipSync resolver not configured');
+    }
+    // Media can come from 'video' or 'image' input port
+    const mediaUrl = inputs.get('video') ?? inputs.get('image');
+    if (!mediaUrl) {
+      throw new Error('Missing required input: video or image');
+    }
+    const audioUrl = this.getRequiredInput(inputs, 'audio');
+    const mode = this.getOptionalConfig(node.config, 'mode', 'image');
+    const result = await this.resolver(
+      mediaUrl,
+      audioUrl,
+      { mode },
+      input.context,
+      node,
+    );
+    return {
+      data: result,
+      metadata: {
+        mode,
+      },
+    };
+  }
+}
+export function createLipSyncExecutor() {
+  return new LipSyncExecutor();
+}

package/dist/src/executors/saas/mention-trigger-executor.d.ts

@@ -0,0 +1,51 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type MentionTriggerPlatform = 'twitter' | 'instagram' | 'threads';
+export interface MentionTriggerOutput {
+  /** The post/tweet ID containing the mention */
+  postId: string;
+  /** URL of the post */
+  postUrl: string;
+  /** Text of the post */
+  text: string;
+  /** Author user ID */
+  authorId: string;
+  /** Author username */
+  authorUsername: string;
+  /** Platform */
+  platform: MentionTriggerPlatform;
+  /** Timestamp of the mention */
+  mentionedAt: string;
+}
+export type MentionChecker = (params: {
+  organizationId: string;
+  platform: MentionTriggerPlatform;
+  keywords?: string[];
+  excludeKeywords?: string[];
+  lastMentionId: string | null;
+}) => Promise<MentionTriggerOutput | null>;
+/**
+ * Mention Trigger Executor
+ *
+ * Starts a workflow when the authenticated user is mentioned.
+ * Polls mentions at configurable intervals and deduplicates.
+ *
+ * Node Type: mentionTrigger
+ */
+export declare class MentionTriggerExecutor extends BaseExecutor {
+  readonly nodeType = 'mentionTrigger';
+  private checker;
+  setChecker(checker: MentionChecker): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+  estimateCost(_node: ExecutableNode): number;
+}
+export declare function createMentionTriggerExecutor(): MentionTriggerExecutor;
+//# sourceMappingURL=mention-trigger-executor.d.ts.map

package/dist/src/executors/saas/mention-trigger-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-trigger-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/mention-trigger-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,sBAAsB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,QAAQ,EAAE,sBAAsB,CAAC;IACjC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAM3C;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,QAAQ,oBAAoB;IACrC,OAAO,CAAC,OAAO,CAA+B;IAE9C,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAsB9D,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAoD5D,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CAG5C;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAErE"}