@genfeedai/workflow-engine 0.2.0

package/dist/execution/resume-handler.d.ts

@@ -0,0 +1,38 @@
+import { type PartialExecutionPlan } from '@workflow-engine/execution/partial-execution';
+import type {
+  ExecutableEdge,
+  ExecutableNode,
+  ExecutionRun,
+  NodeExecutionStatus,
+} from '@workflow-engine/types';
+export interface ResumeAnalysis {
+  canResume: boolean;
+  resumeFromNodeId: string | null;
+  completedNodeIds: string[];
+  previousOutputs: Map<string, unknown>;
+  nodesToReExecute: string[];
+  executionPlan: PartialExecutionPlan | null;
+  reason?: string;
+}
+export declare function analyzeForResume(
+  previousRun: ExecutionRun,
+  nodes: ExecutableNode[],
+  edges: ExecutableEdge[],
+): ResumeAnalysis;
+export declare function createCacheFromRun(
+  previousRun: ExecutionRun,
+): Map<string, unknown>;
+export declare function mergeExecutionResults(
+  previousRun: ExecutionRun,
+  currentResults: Array<{
+    nodeId: string;
+    status: NodeExecutionStatus;
+    output?: unknown;
+    error?: string;
+    startedAt: Date;
+    completedAt?: Date;
+    retryCount: number;
+    creditsUsed: number;
+  }>,
+): ExecutionRun['nodeResults'];
+//# sourceMappingURL=resume-handler.d.ts.map

package/dist/execution/resume-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-handler.d.ts","sourceRoot":"","sources":["../../src/execution/resume-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,YAAY,EACzB,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,GACtB,cAAc,CAsEhB;AAqCD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,YAAY,GACxB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtB;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,YAAY,EACzB,cAAc,EAAE,KAAK,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,GACD,YAAY,CAAC,aAAa,CAAC,CAY7B"}

package/dist/execution/resume-handler.js

@@ -0,0 +1,111 @@
+import { planPartialExecution } from '@workflow-engine/execution/partial-execution';
+export function analyzeForResume(previousRun, nodes, edges) {
+  if (previousRun.status !== 'failed') {
+    return {
+      canResume: false,
+      completedNodeIds: [],
+      executionPlan: null,
+      nodesToReExecute: [],
+      previousOutputs: new Map(),
+      reason: `Cannot resume: run status is ${previousRun.status}, expected 'failed'`,
+      resumeFromNodeId: null,
+    };
+  }
+  if (!previousRun.failedNodeId) {
+    return {
+      canResume: false,
+      completedNodeIds: [],
+      executionPlan: null,
+      nodesToReExecute: [],
+      previousOutputs: new Map(),
+      reason: 'Cannot resume: no failed node ID recorded',
+      resumeFromNodeId: null,
+    };
+  }
+  const failedNode = nodes.find((n) => n.id === previousRun.failedNodeId);
+  if (!failedNode) {
+    return {
+      canResume: false,
+      completedNodeIds: [],
+      executionPlan: null,
+      nodesToReExecute: [],
+      previousOutputs: new Map(),
+      reason: `Cannot resume: failed node ${previousRun.failedNodeId} no longer exists in workflow`,
+      resumeFromNodeId: null,
+    };
+  }
+  const completedNodeIds = [];
+  const previousOutputs = new Map();
+  for (const result of previousRun.nodeResults) {
+    if (result.status === 'completed' && result.output !== undefined) {
+      completedNodeIds.push(result.nodeId);
+      previousOutputs.set(result.nodeId, result.output);
+    }
+  }
+  const nodesToReExecute = findNodesToReExecute(
+    previousRun.failedNodeId,
+    nodes,
+    edges,
+  );
+  const executionPlan = planPartialExecution(
+    nodesToReExecute,
+    nodes,
+    edges,
+    previousOutputs,
+  );
+  return {
+    canResume: executionPlan.isValid,
+    completedNodeIds,
+    executionPlan,
+    nodesToReExecute,
+    previousOutputs,
+    reason: executionPlan.isValid ? undefined : executionPlan.errors.join('; '),
+    resumeFromNodeId: previousRun.failedNodeId,
+  };
+}
+function findNodesToReExecute(failedNodeId, nodes, edges) {
+  const result = new Set();
+  result.add(failedNodeId);
+  const forwardEdges = new Map();
+  for (const node of nodes) {
+    forwardEdges.set(node.id, []);
+  }
+  for (const edge of edges) {
+    const targets = forwardEdges.get(edge.source) ?? [];
+    targets.push(edge.target);
+    forwardEdges.set(edge.source, targets);
+  }
+  const queue = [failedNodeId];
+  while (queue.length > 0) {
+    const current = queue.shift();
+    if (!current) {
+      continue;
+    }
+    for (const downstream of forwardEdges.get(current) ?? []) {
+      if (!result.has(downstream)) {
+        result.add(downstream);
+        queue.push(downstream);
+      }
+    }
+  }
+  return Array.from(result);
+}
+export function createCacheFromRun(previousRun) {
+  const cache = new Map();
+  for (const result of previousRun.nodeResults) {
+    if (result.status === 'completed' && result.output !== undefined) {
+      cache.set(result.nodeId, result.output);
+    }
+  }
+  return cache;
+}
+export function mergeExecutionResults(previousRun, currentResults) {
+  const resultMap = new Map();
+  for (const result of previousRun.nodeResults) {
+    resultMap.set(result.nodeId, result);
+  }
+  for (const result of currentResults) {
+    resultMap.set(result.nodeId, result);
+  }
+  return Array.from(resultMap.values());
+}

package/dist/execution/retry-handler.d.ts

@@ -0,0 +1,20 @@
+import type { RetryConfig } from '@workflow-engine/types';
+export declare function calculateRetryDelay(
+  attemptNumber: number,
+  config?: RetryConfig,
+): number;
+export declare function sleep(ms: number): Promise<void>;
+export declare function isRetryableError(error: unknown): boolean;
+export declare function withRetry<T>(
+  fn: () => Promise<T>,
+  config?: RetryConfig,
+  onRetry?: (attemptNumber: number, error: Error, delayMs: number) => void,
+): Promise<T>;
+export declare function createRetryHandler(config?: Partial<RetryConfig>): {
+  withRetry: <T>(
+    fn: () => Promise<T>,
+    onRetry?: (attemptNumber: number, error: Error, delayMs: number) => void,
+  ) => Promise<T>;
+  config: RetryConfig;
+};
+//# sourceMappingURL=retry-handler.d.ts.map

package/dist/execution/retry-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-handler.d.ts","sourceRoot":"","sources":["../../src/execution/retry-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAuB1D,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,WAAkC,GACzC,MAAM,CAIR;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBxD;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,WAAkC,EAC1C,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACvE,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG;IACrE,SAAS,EAAE,CAAC,CAAC,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,KACrE,OAAO,CAAC,CAAC,CAAC,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;CACrB,CAUA"}

package/dist/execution/retry-handler.js

@@ -0,0 +1,70 @@
+import { DEFAULT_RETRY_CONFIG } from '@workflow-engine/types';
+
+const RETRYABLE_PATTERNS = [
+  'network',
+  'timeout',
+  'econnreset',
+  'rate limit',
+  '429',
+  'too many requests',
+  '503',
+  '502',
+  'service unavailable',
+];
+const NON_RETRYABLE_PATTERNS = [
+  'invalid',
+  'unauthorized',
+  'forbidden',
+  'not found',
+  'validation',
+];
+export function calculateRetryDelay(
+  attemptNumber,
+  config = DEFAULT_RETRY_CONFIG,
+) {
+  const delay = config.baseDelayMs * config.backoffMultiplier ** attemptNumber;
+  const jitter = delay * 0.1 * Math.random();
+  return Math.min(delay + jitter, config.maxDelayMs);
+}
+export function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function isRetryableError(error) {
+  if (!(error instanceof Error)) {
+    return true;
+  }
+  const message = error.message.toLowerCase();
+  if (RETRYABLE_PATTERNS.some((pattern) => message.includes(pattern))) {
+    return true;
+  }
+  if (NON_RETRYABLE_PATTERNS.some((pattern) => message.includes(pattern))) {
+    return false;
+  }
+  return true;
+}
+export async function withRetry(fn, config = DEFAULT_RETRY_CONFIG, onRetry) {
+  let lastError;
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt >= config.maxRetries || !isRetryableError(error)) {
+        throw lastError;
+      }
+      const delay = calculateRetryDelay(attempt, config);
+      if (onRetry) {
+        onRetry(attempt + 1, lastError, delay);
+      }
+      await sleep(delay);
+    }
+  }
+  throw lastError ?? new Error('Retry failed with unknown error');
+}
+export function createRetryHandler(config = {}) {
+  const finalConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+  return {
+    config: finalConfig,
+    withRetry: (fn, onRetry) => withRetry(fn, finalConfig, onRetry),
+  };
+}

package/dist/executors/base-executor.d.ts

@@ -0,0 +1,53 @@
+import type { ExecutionContext } from '@workflow-engine/execution/engine';
+import type { ExecutableNode } from '@workflow-engine/types';
+export interface ExecutorInput {
+  node: ExecutableNode;
+  inputs: Map<string, unknown>;
+  context: ExecutionContext;
+}
+export interface ExecutorOutput {
+  data: unknown;
+  metadata?: Record<string, unknown>;
+}
+export interface INodeExecutor {
+  readonly nodeType: string;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+  validate?(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost?(node: ExecutableNode): number;
+}
+export declare abstract class BaseExecutor implements INodeExecutor {
+  abstract readonly nodeType: string;
+  abstract execute(input: ExecutorInput): Promise<ExecutorOutput>;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(_node: ExecutableNode): number;
+  protected getRequiredInput<T>(inputs: Map<string, unknown>, key: string): T;
+  protected getOptionalInput<T>(
+    inputs: Map<string, unknown>,
+    key: string,
+    defaultValue: T,
+  ): T;
+  protected getRequiredConfig<T>(
+    config: Record<string, unknown>,
+    key: string,
+  ): T;
+  protected getOptionalConfig<T>(
+    config: Record<string, unknown>,
+    key: string,
+    defaultValue: T,
+  ): T;
+}
+export declare class NoopExecutor extends BaseExecutor {
+  readonly nodeType = 'noop';
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createSimpleExecutor(
+  nodeType: string,
+  executeFn: (input: ExecutorInput) => Promise<unknown>,
+): INodeExecutor;
+//# sourceMappingURL=base-executor.d.ts.map

package/dist/executors/base-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-executor.d.ts","sourceRoot":"","sources":["../../src/executors/base-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,QAAQ,CAAC,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtE,YAAY,CAAC,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;CAC7C;AAED,8BAAsB,YAAa,YAAW,aAAa;IACzD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAEnC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAE/D,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAapE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAI3C,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAQ3E,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC;IAKJ,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,GACV,CAAC;IAQJ,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC;CAIL;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,QAAQ,CAAC,QAAQ,UAAU;IAE3B,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CASvD;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,GACpD,aAAa,CAQf"}

package/dist/executors/base-executor.js

@@ -0,0 +1,58 @@
+export class BaseExecutor {
+  validate(node) {
+    const errors = [];
+    if (node.type !== this.nodeType) {
+      errors.push(`Expected node type ${this.nodeType}, got ${node.type}`);
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  estimateCost(_node) {
+    return 0;
+  }
+  getRequiredInput(inputs, key) {
+    const value = inputs.get(key);
+    if (value === undefined) {
+      throw new Error(`Missing required input: ${key}`);
+    }
+    return value;
+  }
+  getOptionalInput(inputs, key, defaultValue) {
+    const value = inputs.get(key);
+    return value ?? defaultValue;
+  }
+  getRequiredConfig(config, key) {
+    const value = config[key];
+    if (value === undefined) {
+      throw new Error(`Missing required config: ${key}`);
+    }
+    return value;
+  }
+  getOptionalConfig(config, key, defaultValue) {
+    const value = config[key];
+    return value ?? defaultValue;
+  }
+}
+export class NoopExecutor extends BaseExecutor {
+  nodeType = 'noop';
+  execute(input) {
+    const firstInput = input.inputs.values().next().value;
+    return Promise.resolve({
+      data: firstInput ?? null,
+      metadata: {
+        passthrough: true,
+      },
+    });
+  }
+}
+export function createSimpleExecutor(nodeType, executeFn) {
+  return {
+    async execute(input) {
+      const data = await executeFn(input);
+      return { data };
+    },
+    nodeType,
+  };
+}

package/dist/executors/executor-registry.d.ts

@@ -0,0 +1,269 @@
+import type { INodeExecutor } from '@workflow-engine/executors/base-executor';
+import { BeatAnalysisExecutor } from '@workflow-engine/executors/saas/beat-analysis-executor';
+import { BeatSyncEditorExecutor } from '@workflow-engine/executors/saas/beat-sync-editor-executor';
+import { BrandAssetExecutor } from '@workflow-engine/executors/saas/brand-asset-executor';
+import { BrandContextExecutor } from '@workflow-engine/executors/saas/brand-context-executor';
+import { BrandExecutor } from '@workflow-engine/executors/saas/brand-executor';
+import { CinematicColorGradeExecutor } from '@workflow-engine/executors/saas/cinematic-color-grade-executor';
+import { ColorGradeExecutor } from '@workflow-engine/executors/saas/color-grade-executor';
+import { ConditionExecutor } from '@workflow-engine/executors/saas/condition-executor';
+import { DelayExecutor } from '@workflow-engine/executors/saas/delay-executor';
+import { EngagementTriggerExecutor } from '@workflow-engine/executors/saas/engagement-trigger-executor';
+import { FilmGrainExecutor } from '@workflow-engine/executors/saas/film-grain-executor';
+import { ImageGenExecutor } from '@workflow-engine/executors/saas/image-gen-executor';
+import { KeywordTriggerExecutor } from '@workflow-engine/executors/saas/keyword-trigger-executor';
+import { LensEffectsExecutor } from '@workflow-engine/executors/saas/lens-effects-executor';
+import { LipSyncExecutor } from '@workflow-engine/executors/saas/lip-sync-executor';
+import { MentionTriggerExecutor } from '@workflow-engine/executors/saas/mention-trigger-executor';
+import { MusicSourceExecutor } from '@workflow-engine/executors/saas/music-source-executor';
+import { NewFollowerTriggerExecutor } from '@workflow-engine/executors/saas/new-follower-trigger-executor';
+import { NewLikeTriggerExecutor } from '@workflow-engine/executors/saas/new-like-trigger-executor';
+import { NewRepostTriggerExecutor } from '@workflow-engine/executors/saas/new-repost-trigger-executor';
+import { PatternContextExecutor } from '@workflow-engine/executors/saas/pattern-context-executor';
+import { PostReplyExecutor } from '@workflow-engine/executors/saas/post-reply-executor';
+import { PublishExecutor } from '@workflow-engine/executors/saas/publish-executor';
+import { ReframeExecutor } from '@workflow-engine/executors/saas/reframe-executor';
+import { RssInputExecutor } from '@workflow-engine/executors/saas/rss-input-executor';
+import { SendDmExecutor } from '@workflow-engine/executors/saas/send-dm-executor';
+import { SocialPublishExecutor } from '@workflow-engine/executors/saas/social-publish-executor';
+import { SoundOverlayExecutor } from '@workflow-engine/executors/saas/sound-overlay-executor';
+import { TextToSpeechExecutor } from '@workflow-engine/executors/saas/text-to-speech-executor';
+import { TrendTriggerExecutor } from '@workflow-engine/executors/saas/trend-trigger-executor';
+import { TweetInputExecutor } from '@workflow-engine/executors/saas/tweet-input-executor';
+import { TweetRemixExecutor } from '@workflow-engine/executors/saas/tweet-remix-executor';
+import { UpscaleExecutor } from '@workflow-engine/executors/saas/upscale-executor';
+import { VideoInputExecutor } from '@workflow-engine/executors/saas/video-input-executor';
+import { VoiceChangeExecutor } from '@workflow-engine/executors/saas/voice-change-executor';
+/**
+ * Node Type to Executor Mapping
+ *
+ * This registry maps node types (from @genfeedai/workflow-saas) to their
+ * executor implementations in this package.
+ *
+ * | Node Type       | Executor                 | Package Location                      |
+ * |-----------------|--------------------------|---------------------------------------|
+ * | brand           | BrandExecutor            | ./saas/brand-executor.ts              |
+ * | brandContext    | BrandContextExecutor     | ./saas/brand-context-executor.ts      |
+ * | brandAsset      | BrandAssetExecutor       | ./saas/brand-asset-executor.ts        |
+ * | publish         | PublishExecutor          | ./saas/publish-executor.ts            |
+ * | tweetInput      | TweetInputExecutor       | ./saas/tweet-input-executor.ts        |
+ * | tweetRemix      | TweetRemixExecutor       | ./saas/tweet-remix-executor.ts        |
+ * | rssInput        | RssInputExecutor         | ./saas/rss-input-executor.ts          |
+ * | socialPublish   | SocialPublishExecutor    | ./saas/social-publish-executor.ts     |
+ * | trendTrigger    | TrendTriggerExecutor     | ./saas/trend-trigger-executor.ts      |
+ * | soundOverlay    | SoundOverlayExecutor     | ./saas/sound-overlay-executor.ts      |
+ * | videoInput      | VideoInputExecutor       | ./saas/video-input-executor.ts        |
+ * | musicSource     | MusicSourceExecutor      | ./saas/music-source-executor.ts       |
+ * | beatAnalysis    | BeatAnalysisExecutor     | ./saas/beat-analysis-executor.ts      |
+ * | beatSyncEditor  | BeatSyncEditorExecutor   | ./saas/beat-sync-editor-executor.ts   |
+ * | colorGrade      | ColorGradeExecutor       | ./saas/color-grade-executor.ts        |
+ * | cinematicColorGrade | CinematicColorGradeExecutor | ./saas/cinematic-color-grade-executor.ts |
+ * | filmGrain       | FilmGrainExecutor        | ./saas/film-grain-executor.ts         |
+ * | lensEffects     | LensEffectsExecutor      | ./saas/lens-effects-executor.ts       |
+ * | promptConstructor | PromptConstructorExecutor | ./saas/prompt-constructor-executor.ts |
+ * | voiceChange     | VoiceChangeExecutor      | ./saas/voice-change-executor.ts       |
+ * | lipSync         | LipSyncExecutor          | ./saas/lip-sync-executor.ts           |
+ * | textToSpeech    | TextToSpeechExecutor     | ./saas/text-to-speech-executor.ts     |
+ * | patternContext  | PatternContextExecutor   | ./saas/pattern-context-executor.ts    |
+ * | reframe         | ReframeExecutor          | ./saas/reframe-executor.ts            |
+ * | upscale         | UpscaleExecutor          | ./saas/upscale-executor.ts            |
+ *
+ * Executors require "resolvers" to be injected at runtime since they need
+ * access to database operations and external services.
+ */
+export type ExecutorFactory<T extends INodeExecutor = INodeExecutor> = () => T;
+export interface ExecutorRegistryEntry {
+  nodeType: string;
+  executorClass: new () => INodeExecutor;
+  factory: ExecutorFactory;
+  description: string;
+  requiresResolver: boolean;
+}
+/**
+ * Registry of all available node executors
+ */
+export declare const EXECUTOR_REGISTRY: Record<string, ExecutorRegistryEntry>;
+/**
+ * Get an executor for a specific node type
+ */
+export declare function getExecutor(
+  nodeType: string,
+): INodeExecutor | undefined;
+/**
+ * Check if an executor exists for a node type
+ */
+export declare function hasExecutor(nodeType: string): boolean;
+/**
+ * Get all registered node types
+ */
+export declare function getRegisteredNodeTypes(): string[];
+/**
+ * Get executor metadata for a node type
+ */
+export declare function getExecutorMetadata(
+  nodeType: string,
+): Omit<ExecutorRegistryEntry, 'factory' | 'executorClass'> | undefined;
+/**
+ * Create an executor registry instance for workflow execution
+ *
+ * This creates a mutable registry that can have resolvers injected
+ * for executors that need them (brand, publish, etc.)
+ */
+export declare function createExecutorRegistry(): ExecutorRegistryInstance;
+export declare class ExecutorRegistryInstance {
+  private executors;
+  constructor();
+  get(nodeType: string): INodeExecutor | undefined;
+  set(nodeType: string, executor: INodeExecutor): void;
+  has(nodeType: string): boolean;
+  /**
+   * Register a custom executor for a node type
+   */
+  register(
+    nodeType: string,
+    executeFn: (
+      input: Parameters<INodeExecutor['execute']>[0],
+    ) => Promise<unknown>,
+  ): void;
+  /**
+   * Get the condition executor
+   */
+  getConditionExecutor(): ConditionExecutor | undefined;
+  /**
+   * Get the delay executor for optimal time resolver injection
+   */
+  getDelayExecutor(): DelayExecutor | undefined;
+  /**
+   * Get the brand executor for resolver injection
+   */
+  getBrandExecutor(): BrandExecutor | undefined;
+  /**
+   * Get the brand context executor for resolver injection
+   */
+  getBrandContextExecutor(): BrandContextExecutor | undefined;
+  /**
+   * Get the brand asset executor for resolver injection
+   */
+  getBrandAssetExecutor(): BrandAssetExecutor | undefined;
+  /**
+   * Get the publish executor for resolver injection
+   */
+  getPublishExecutor(): PublishExecutor | undefined;
+  /**
+   * Get the tweet input executor for fetcher injection
+   */
+  getTweetInputExecutor(): TweetInputExecutor | undefined;
+  /**
+   * Get the tweet remix executor for remixer injection
+   */
+  getTweetRemixExecutor(): TweetRemixExecutor | undefined;
+  /**
+   * Get the RSS input executor for fetcher/parser injection
+   */
+  getRssInputExecutor(): RssInputExecutor | undefined;
+  /**
+   * Get the social publish executor for publisher injection
+   */
+  getSocialPublishExecutor(): SocialPublishExecutor | undefined;
+  /**
+   * Get the trend trigger executor for checker injection
+   */
+  getTrendTriggerExecutor(): TrendTriggerExecutor | undefined;
+  /**
+   * Get the sound overlay executor for processor injection
+   */
+  getSoundOverlayExecutor(): SoundOverlayExecutor | undefined;
+  /**
+   * Get the video input executor for validator injection
+   */
+  getVideoInputExecutor(): VideoInputExecutor | undefined;
+  /**
+   * Get the music source executor for resolver injection
+   */
+  getMusicSourceExecutor(): MusicSourceExecutor | undefined;
+  /**
+   * Get the beat analysis executor for analyzer injection
+   */
+  getBeatAnalysisExecutor(): BeatAnalysisExecutor | undefined;
+  /**
+   * Get the beat sync editor executor for editor injection
+   */
+  getBeatSyncEditorExecutor(): BeatSyncEditorExecutor | undefined;
+  /**
+   * Get the cinematic color grade executor for processor injection
+   */
+  getCinematicColorGradeExecutor(): CinematicColorGradeExecutor | undefined;
+  /**
+   * Get the color grade executor for processor injection
+   */
+  getColorGradeExecutor(): ColorGradeExecutor | undefined;
+  /**
+   * Get the film grain executor for processor injection
+   */
+  getFilmGrainExecutor(): FilmGrainExecutor | undefined;
+  /**
+   * Get the lens effects executor for processor injection
+   */
+  getLensEffectsExecutor(): LensEffectsExecutor | undefined;
+  /**
+   * Get the pattern context executor for resolver injection
+   */
+  getPatternContextExecutor(): PatternContextExecutor | undefined;
+  /**
+   * Get the post reply executor for publisher injection
+   */
+  getPostReplyExecutor(): PostReplyExecutor | undefined;
+  /**
+   * Get the send DM executor for sender injection
+   */
+  getSendDmExecutor(): SendDmExecutor | undefined;
+  /**
+   * Get the new follower trigger executor for checker injection
+   */
+  getNewFollowerTriggerExecutor(): NewFollowerTriggerExecutor | undefined;
+  /**
+   * Get the mention trigger executor for checker injection
+   */
+  getMentionTriggerExecutor(): MentionTriggerExecutor | undefined;
+  /**
+   * Get the new like trigger executor for checker injection
+   */
+  getNewLikeTriggerExecutor(): NewLikeTriggerExecutor | undefined;
+  /**
+   * Get the new repost trigger executor for checker injection
+   */
+  getNewRepostTriggerExecutor(): NewRepostTriggerExecutor | undefined;
+  /**
+   * Get the image gen executor for resolver injection
+   */
+  getImageGenExecutor(): ImageGenExecutor | undefined;
+  /**
+   * Get the voice change executor for resolver injection
+   */
+  getVoiceChangeExecutor(): VoiceChangeExecutor | undefined;
+  /**
+   * Get the keyword trigger executor for checker injection
+   */
+  getKeywordTriggerExecutor(): KeywordTriggerExecutor | undefined;
+  /**
+   * Get the engagement trigger executor for checker injection
+   */
+  getEngagementTriggerExecutor(): EngagementTriggerExecutor | undefined;
+  /**
+   * Get the reframe executor for resolver injection
+   */
+  getReframeExecutor(): ReframeExecutor | undefined;
+  /**
+   * Get the upscale executor for resolver injection
+   */
+  getUpscaleExecutor(): UpscaleExecutor | undefined;
+  /**
+   * Get the lip sync executor for resolver injection
+   */
+  getLipSyncExecutor(): LipSyncExecutor | undefined;
+  /**
+   * Get the text to speech executor for resolver injection
+   */
+  getTextToSpeechExecutor(): TextToSpeechExecutor | undefined;
+}
+//# sourceMappingURL=executor-registry.d.ts.map

package/dist/executors/executor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-registry.d.ts","sourceRoot":"","sources":["../../src/executors/executor-registry.ts"],"names":[],"mappings":"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"}