@genfeedai/workflow-engine 0.2.0

package/dist/src/validation/workflow-validator.js

@@ -0,0 +1,211 @@
+const DEFAULT_VALIDATION_OPTIONS = {
+  checkDisconnected: true,
+  maxNodes: 100,
+  validateConfigs: true,
+};
+export function validateWorkflow(workflow, options = {}) {
+  const opts = { ...DEFAULT_VALIDATION_OPTIONS, ...options };
+  const errors = [];
+  const warnings = [];
+  if (!workflow.id) {
+    errors.push({
+      code: 'MISSING_ID',
+      message: 'Workflow ID is required',
+    });
+  }
+  if (!workflow.organizationId) {
+    errors.push({
+      code: 'MISSING_ORG',
+      message: 'Organization ID is required',
+    });
+  }
+  if (!workflow.nodes || workflow.nodes.length === 0) {
+    errors.push({
+      code: 'NO_NODES',
+      message: 'Workflow must have at least one node',
+    });
+  }
+  if (opts.maxNodes && workflow.nodes.length > opts.maxNodes) {
+    errors.push({
+      code: 'TOO_MANY_NODES',
+      message: `Workflow has ${workflow.nodes.length} nodes, maximum allowed is ${opts.maxNodes}`,
+    });
+  }
+  const nodeIds = new Set();
+  for (const node of workflow.nodes) {
+    if (nodeIds.has(node.id)) {
+      errors.push({
+        code: 'DUPLICATE_NODE_ID',
+        message: `Duplicate node ID: ${node.id}`,
+        nodeId: node.id,
+      });
+    }
+    nodeIds.add(node.id);
+    if (!node.type) {
+      errors.push({
+        code: 'MISSING_NODE_TYPE',
+        message: `Node ${node.id} is missing type`,
+        nodeId: node.id,
+      });
+    }
+    if (!node.label) {
+      warnings.push({
+        code: 'MISSING_NODE_LABEL',
+        message: `Node ${node.id} is missing label`,
+        nodeId: node.id,
+      });
+    }
+  }
+  const edgeIds = new Set();
+  for (const edge of workflow.edges) {
+    if (edgeIds.has(edge.id)) {
+      errors.push({
+        code: 'DUPLICATE_EDGE_ID',
+        message: `Duplicate edge ID: ${edge.id}`,
+      });
+    }
+    edgeIds.add(edge.id);
+    if (!nodeIds.has(edge.source)) {
+      errors.push({
+        code: 'INVALID_EDGE_SOURCE',
+        message: `Edge ${edge.id} references non-existent source node: ${edge.source}`,
+      });
+    }
+    if (!nodeIds.has(edge.target)) {
+      errors.push({
+        code: 'INVALID_EDGE_TARGET',
+        message: `Edge ${edge.id} references non-existent target node: ${edge.target}`,
+      });
+    }
+    if (edge.source === edge.target) {
+      errors.push({
+        code: 'SELF_LOOP',
+        message: `Edge ${edge.id} creates a self-loop on node ${edge.source}`,
+      });
+    }
+  }
+  const hasCycle = detectCycle(workflow.nodes, workflow.edges);
+  if (hasCycle) {
+    errors.push({
+      code: 'CYCLE_DETECTED',
+      message: 'Workflow contains a cycle, which is not allowed',
+    });
+  }
+  if (opts.checkDisconnected && workflow.nodes.length > 1) {
+    const connectedNodes = findConnectedNodes(workflow.nodes, workflow.edges);
+    for (const node of workflow.nodes) {
+      if (!connectedNodes.has(node.id)) {
+        warnings.push({
+          code: 'DISCONNECTED_NODE',
+          message: `Node ${node.id} is not connected to any other node`,
+          nodeId: node.id,
+        });
+      }
+    }
+  }
+  if (opts.requiredNodeTypes && opts.requiredNodeTypes.length > 0) {
+    const presentTypes = new Set(workflow.nodes.map((n) => n.type));
+    for (const requiredType of opts.requiredNodeTypes) {
+      if (!presentTypes.has(requiredType)) {
+        errors.push({
+          code: 'MISSING_REQUIRED_TYPE',
+          message: `Workflow must contain at least one ${requiredType} node`,
+        });
+      }
+    }
+  }
+  return {
+    errors,
+    isValid: errors.length === 0,
+    warnings,
+  };
+}
+function detectCycle(nodes, edges) {
+  const adjList = new Map();
+  for (const node of nodes) {
+    adjList.set(node.id, []);
+  }
+  for (const edge of edges) {
+    const targets = adjList.get(edge.source) ?? [];
+    targets.push(edge.target);
+    adjList.set(edge.source, targets);
+  }
+  const visited = new Set();
+  const recStack = new Set();
+  function dfs(nodeId) {
+    visited.add(nodeId);
+    recStack.add(nodeId);
+    for (const neighbor of adjList.get(nodeId) ?? []) {
+      if (!visited.has(neighbor)) {
+        if (dfs(neighbor)) {
+          return true;
+        }
+      } else if (recStack.has(neighbor)) {
+        return true;
+      }
+    }
+    recStack.delete(nodeId);
+    return false;
+  }
+  for (const node of nodes) {
+    if (!visited.has(node.id)) {
+      if (dfs(node.id)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function findConnectedNodes(_nodes, edges) {
+  const connected = new Set();
+  for (const edge of edges) {
+    connected.add(edge.source);
+    connected.add(edge.target);
+  }
+  return connected;
+}
+export function validateNodeConfig(node, schema) {
+  const errors = [];
+  for (const [field, rules] of Object.entries(schema)) {
+    const value = node.config[field];
+    if (
+      rules.required &&
+      (value === undefined || value === null || value === '')
+    ) {
+      errors.push({
+        code: 'MISSING_REQUIRED_FIELD',
+        field,
+        message: `Node ${node.id} is missing required field: ${field}`,
+        nodeId: node.id,
+      });
+    }
+    if (value !== undefined && rules.type) {
+      const actualType = typeof value;
+      if (actualType !== rules.type) {
+        errors.push({
+          code: 'INVALID_FIELD_TYPE',
+          field,
+          message: `Node ${node.id} field ${field} should be ${rules.type}, got ${actualType}`,
+          nodeId: node.id,
+        });
+      }
+    }
+  }
+  return errors;
+}
+export function hasInputNodes(workflow) {
+  const targetNodes = new Set(workflow.edges.map((e) => e.target));
+  return workflow.nodes.some((n) => !targetNodes.has(n.id));
+}
+export function hasOutputNodes(workflow) {
+  const sourceNodes = new Set(workflow.edges.map((e) => e.source));
+  return workflow.nodes.some((n) => !sourceNodes.has(n.id));
+}
+export function getInputNodes(workflow) {
+  const targetNodes = new Set(workflow.edges.map((e) => e.target));
+  return workflow.nodes.filter((n) => !targetNodes.has(n.id));
+}
+export function getOutputNodes(workflow) {
+  const sourceNodes = new Set(workflow.edges.map((e) => e.source));
+  return workflow.nodes.filter((n) => !sourceNodes.has(n.id));
+}

package/dist/src/workflows-contracts-shim.d.ts

@@ -0,0 +1,117 @@
+export type ExecutionStatus =
+  | 'pending'
+  | 'running'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
+export type NodeExecutionStatus =
+  | 'pending'
+  | 'running'
+  | 'completed'
+  | 'failed'
+  | 'skipped';
+export type WorkflowLifecycle = 'draft' | 'published' | 'archived';
+export interface ExecutionProgressEvent {
+  runId: string;
+  workflowId: string;
+  progress: number;
+  currentNodeId?: string;
+  currentNodeLabel?: string;
+  completedNodes: string[];
+  failedNodes: string[];
+  timestamp: Date;
+}
+export interface NodeStatusChangeEvent {
+  runId: string;
+  workflowId: string;
+  nodeId: string;
+  previousStatus: NodeExecutionStatus;
+  newStatus: NodeExecutionStatus;
+  error?: string;
+  output?: unknown;
+  timestamp: Date;
+}
+export interface ExecutionOptions {
+  nodeIds?: string[];
+  resumeFromNodeId?: string;
+  respectLocks?: boolean;
+  maxRetries?: number;
+  onProgress?: (event: ExecutionProgressEvent) => void;
+  onNodeStatusChange?: (event: NodeStatusChangeEvent) => void;
+  availableCredits?: number;
+  dryRun?: boolean;
+}
+export interface ExecutableNode {
+  id: string;
+  type: string;
+  label: string;
+  config: Record<string, unknown>;
+  inputs: string[];
+  isLocked?: boolean;
+  cachedOutput?: unknown;
+}
+export interface ExecutableEdge {
+  id: string;
+  source: string;
+  target: string;
+  sourceHandle?: string;
+  targetHandle?: string;
+}
+export interface ExecutableWorkflow {
+  id: string;
+  organizationId: string;
+  userId: string;
+  nodes: ExecutableNode[];
+  edges: ExecutableEdge[];
+  lockedNodeIds: string[];
+}
+export interface ValidationResult {
+  isValid: boolean;
+  errors: ValidationError[];
+  warnings: ValidationWarning[];
+}
+export interface ValidationError {
+  code: string;
+  message: string;
+  nodeId?: string;
+  field?: string;
+}
+export interface ValidationWarning {
+  code: string;
+  message: string;
+  nodeId?: string;
+}
+export interface RetryConfig {
+  maxRetries: number;
+  baseDelayMs: number;
+  maxDelayMs: number;
+  backoffMultiplier: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export type SaaSHandleType =
+  | 'image'
+  | 'text'
+  | 'video'
+  | 'number'
+  | 'audio'
+  | 'brand'
+  | 'object'
+  | 'any';
+export interface SaaSHandleDefinition {
+  id: string;
+  type: SaaSHandleType;
+  label: string;
+  required?: boolean;
+  multiple?: boolean;
+}
+export type ExtendedNodeCategory =
+  | 'input'
+  | 'ai'
+  | 'processing'
+  | 'output'
+  | 'distribution'
+  | 'composition'
+  | 'automation'
+  | 'repurposing'
+  | 'saas';
+//# sourceMappingURL=workflows-contracts-shim.d.ts.map

package/dist/src/workflows-contracts-shim.d.ts.map

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

package/dist/src/workflows-contracts-shim.js

@@ -0,0 +1,6 @@
+export const DEFAULT_RETRY_CONFIG = {
+  backoffMultiplier: 2,
+  baseDelayMs: 1000,
+  maxDelayMs: 30000,
+  maxRetries: 3,
+};

package/dist/templates/cinematic-video.template.d.ts

@@ -0,0 +1,62 @@
+import type { ExecutableEdge, ExecutableNode } from '@workflow-engine/types';
+export interface WorkflowTemplate {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  nodes: ExecutableNode[];
+  edges: ExecutableEdge[];
+  metadata: {
+    version: string;
+    createdAt: string;
+    tags: string[];
+  };
+}
+/**
+ * Cinematic Video Workflow Template
+ *
+ * Workflow chain:
+ * 1. CAST prompt generation
+ * 2. Video generation (model TBD: Sora/Kling/etc)
+ * 3. Upscale pass 1
+ * 4. Upscale pass 2 (optional)
+ * 5. Color grade (from preset)
+ * 6. Film grain (from preset)
+ * 7. Lens effects (from preset)
+ * 8. Platform export
+ */
+export declare const CINEMATIC_VIDEO_TEMPLATE: WorkflowTemplate;
+/**
+ * Create a new workflow instance from the template with custom config
+ */
+export declare const createCinematicWorkflowInstance: (config: {
+  workflowId: string;
+  organizationId: string;
+  userId: string;
+  castConfig?: Partial<{
+    presetId: string;
+    cameraMovement: string;
+    action: string;
+    subject: string;
+    lighting: string;
+    colorPalette: string;
+    mood: string;
+  }>;
+  videoConfig?: Partial<{
+    model: string;
+    duration: number;
+    aspectRatio: string;
+    fps: number;
+  }>;
+  enableSecondUpscale?: boolean;
+  exportPlatforms?: string[];
+}) => any;
+/**
+ * Get list of all available workflow templates
+ */
+export declare const getAvailableTemplates: () => WorkflowTemplate[];
+/**
+ * Get template by ID
+ */
+export declare const getTemplateById: (id: string) => WorkflowTemplate | null;
+//# sourceMappingURL=cinematic-video.template.d.ts.map

package/dist/templates/cinematic-video.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cinematic-video.template.d.ts","sourceRoot":"","sources":["../../src/templates/cinematic-video.template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBAmPtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAAI,QAAQ;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,QAoDA,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAO,gBAAgB,EAExD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,IAAI,MAAM,KAAG,gBAAgB,GAAG,IAG/D,CAAC"}